오퍼레이션 내용

오퍼레이션 내용 설명
내용	상가업소정보에서 사용되는 업종코드를 조회하는 기능입니다. 앱/웹에서 업종 선택기능을 제공하는 콤보박스 표현 용도로 본 API를 활용할 수 있습니다.
형식	시도 조회 http://apis.data.go.kr/B553077/api/open/sdsc2/baroApi?resId=dong&catId=mega&ServiceKey=서비스인증키 시군구 조회 http://apis.data.go.kr/B553077/api/open/sdsc2/baroApi?resId=dong&catId=cty&ctprvnCd=시도코드&ServiceKey=서비스인증키 행정동 조회 http://apis.data.go.kr/B553077/api/open/sdsc2/baroApi?resId=dong&catId=admi&signguCd=시군구코드&ServiceKey=서비스인증키 법정동 조회 http://apis.data.go.kr/B553077/api/open/sdsc2/baroApi?resId=dong&catId=zone&signguCd=시군구코드&serviceKey=서비스인증키

요청 메시지 (Request Parameter)

서비스 명세를 서비스명과 오퍼레이션 오퍼레이션명으로 표기
항목명	항목설명	기본값	필수항목	상세내용
serviceKey	서비스인증키	인증키(URL Encode)	필수	공공데이터포털에서 발급받은 인증키
resId	리소스 ID	dong	필수	리소스에 대한 ID로 dong은 행정구역 리소스를 나타낸다.
catId	카테고리 ID	mega	필수	리소스에서 카테고리를 구분하는 항목으로 행정구역 API에서는 mega는 시도에 해당한다.
ctprvnCd	시도코드	11	필수	시도코드 입력
signguCd	시군구코드	11740	필수	시군구코드 입력
type	데이터유형	xml	옵션	데이터유형(xml,json)으로 xml, json 포맷을 제공

요청 예시

http://apis.data.go.kr/B553077/api/open/sdsc2/baroApi?resId=dong&catId=mega&ServiceKey=서비스인증키

http://apis.data.go.kr/B553077/api/open/sdsc2/baroApi?resId=dong&catId=cty&ctprvnCd=시도코드&ServiceKey=서비스인증키

http://apis.data.go.kr/B553077/api/open/sdsc2/baroApi?resId=dong&catId=cty&ctprvnCd=11&serviceKey=서비스인증키

http://apis.data.go.kr/B553077/api/open/sdsc2/baroApi?resId=dong&catId=admi&signguCd=시군구코드&serviceKey=서비스인증키

http://apis.data.go.kr/B553077/api/open/sdsc2/baroApi?resId=dong&catId=admi&signguCd=11740&serviceKey=서비스인증키

http://apis.data.go.kr/B553077/api/open/sdsc2/baroApi?resId=dong&catId=admi&signguCd=시군구코드&serviceKey=서비스인증키

http://apis.data.go.kr/B553077/api/open/sdsc2/baroApi?resId=dong&catId=zone&signguCd=11740&serviceKey=서비스인증키

응답 메시지 (Response Message)

서비스 명세를 서비스명과 오퍼레이션 오퍼레이션명으로 표기
구분	항목	항목설명
header	데이터설명, 항목컬럼, 결과코드, 결과메시지를 가지고 있다.
	description	데이터설명
	columns	항목 리스트(배열)
	resultCode	결과코드값(응답 메시지 코드표 참고)
	resultMsg	결과메시지
body	결과데이터 배열을 가지고 있다.
	items	결과 항목(item) 배열

결과 항목 구성 (item)

응답 메시지 코드표 (공공데이터포털 제공)을 에러코드에 따라 에러메세지와 설명으로 표기
항목명	항목설명	데이터타입(길이)	항목샘플	상세내용
ctprvnCd	시도코드	문자형(2)	11	시도코드
ctprvnNm	시도명	가변문자형(10)	서울특별시	시도명
signguCd	시군구코드	문자형(5)	11740	시군구코드
signguNm	시군구명	가변문자형(10)	강동구	시군구명
adongCd	행정동코드	문자형(10)	1174051500	행정동코드
adongNm	행정동명	가변문자형(10)	강일동	행정동명
ldongCd	법정동코드	문자형(10)	1174011000	법정동코드
ldongNm	법정동명	가변문자형(10)	강일동	법정동명
stdrDt	데이터기준일자	문자형(10)	2015-12-17	해당 상가업소 데이터의 기준일자

출력 예시 (JSON ㅣ XML)

{
    "header" : {
        "description" : "소상공인시장진흥공단 상권정보 업종소분류 코드"
        ,"columns" : ["상권업종대분류코드","상권업종대분류코드명","상권업종중분류코드","상권업종중분류코드명","상권업종소분류코드","상권업종소분류코드명","데이터기준일자"]
        ,"resultCode" : "00"
        ,"resultMsg" : "NORMAL SERVICE"
    },
    "body" : {
            "items" : [
                {
                "indsLclsCd" : "Q"
                ,"indsLclsNm" : "음식"
                ,"indsMclsCd" : "Q12"
                ,"indsMclsNm" : "커피점/카페"
                ,"indsSclsCd" : "Q12A04"
                ,"indsSclsNm" : "보드게임카페"
                ,"stdrDt" : "2015-12-17"
                }
                ,{
                "indsLclsCd" : "Q"
                ,"indsLclsNm" : "음식"
                ,"indsMclsCd" : "Q12"
                ,"indsMclsNm" : "커피점/카페"
                ,"indsSclsCd" : "Q12A05"
                ,"indsSclsNm" : "사주카페"
                ,"stdrDt" : "2015-12-17"
                }
                ,{
                "indsLclsCd" : "Q"
                ,"indsLclsNm" : "음식"
                ,"indsMclsCd" : "Q12"
                ,"indsMclsNm" : "커피점/카페"
                ,"indsSclsCd" : "Q12A03"
                ,"indsSclsNm" : "생과일주스전문점"
                ,"stdrDt" : "2015-12-17"
                }
                ,{
                "indsLclsCd" : "Q"
                ,"indsLclsNm" : "음식"
                ,"indsMclsCd" : "Q12"
                ,"indsMclsNm" : "커피점/카페"
                ,"indsSclsCd" : "Q12A07"
                ,"indsSclsNm" : "애견카페"
                ,"stdrDt" : "2015-12-17"
                }
                ,{
                "indsLclsCd" : "Q"
                ,"indsLclsNm" : "음식"
                ,"indsMclsCd" : "Q12"
                ,"indsMclsNm" : "커피점/카페"
                ,"indsSclsCd" : "Q12A06"
                ,"indsSclsNm" : "전통찻집/인삼찻집"
                ,"stdrDt" : "2015-12-17"
                }
                ,{
                "indsLclsCd" : "Q"
                ,"indsLclsNm" : "음식"
                ,"indsMclsCd" : "Q12"
                ,"indsMclsNm" : "커피점/카페"
                ,"indsSclsCd" : "Q12A01"
                ,"indsSclsNm" : "커피전문점/카페/다방"
                ,"stdrDt" : "2015-12-17"
                }
            ]
    }
}

<response>
    <header>
        <description>소상공인시장진흥공단 상권정보 시도 코드</description>
        <columns>시도코드,시도명,기준일자</columns>
        <resultCode>00</resultCode>
        <resultMsg>NORMAL SERVICE</resultMsg>
    </header>
    <body>
        <items>
            <item>
                <ctprvnCd>42</ctprvnCd>
                <ctprvnNm>강원도</ctprvnNm>
                <stdrDt>2020-12-31</stdrDt>
            </item>
            <item>
                <ctprvnCd>41</ctprvnCd>
                <ctprvnNm>경기도</ctprvnNm>
                <stdrDt>2020-12-31</stdrDt>
            </item>
            ......
            <item>
                <ctprvnCd>43</ctprvnCd>
                <ctprvnNm>충청북도</ctprvnNm>
                <stdrDt>2020-12-31</stdrDt>
            </item>
        </items>
    </body>
</response>

<response>
    <header>
        <description>소상공인시장진흥공단 상권정보 시군구 코드</description>
        <columns>시도코드,시도명,시군구코드,시군구명,기준일자</columns>
        <resultCode>00</resultCode>
        <resultMsg>NORMAL SERVICE</resultMsg>
    </header>
    <body>
        <items>
            <item>
                <ctprvnCd>11</ctprvnCd>
                <ctprvnNm>서울특별시</ctprvnNm>
                <signguCd>11680</signguCd>
                <signguNm>강남구</signguNm>
                <stdrDt>2020-12-31</stdrDt>
            </item>
            <item>
                <ctprvnCd>11</ctprvnCd>
                <ctprvnNm>서울특별시</ctprvnNm>
                <signguCd>11740</signguCd>
                <signguNm>강동구</signguNm>
                <stdrDt>2020-12-31</stdrDt>
            </item>
            ......
            <item>
                <ctprvnCd>11</ctprvnCd>
                <ctprvnNm>서울특별시</ctprvnNm>
                <signguCd>11260</signguCd>
                <signguNm>중랑구</signguNm>
                <stdrDt>2020-12-31</stdrDt>
            </item>
        </items>
    </body>
</response>

  <response>
    <header>
        <description>소상공인시장진흥공단 상권정보 행정동 코드</description>
        <columns>시도코드,시도명,시군구코드,시군구명,행정동코드,행정동명,기준일자</columns>
        <resultCode>00</resultCode>
        <resultMsg>NORMAL SERVICE</resultMsg>
    </header>
    <body>
        <items>
            <item>
                <ctprvnCd>11</ctprvnCd>
                <ctprvnNm>서울특별시</ctprvnNm>
                <signguCd>11740</signguCd>
                <signguNm>강동구</signguNm>
                <adongCd>1174051500</adongCd>
                <adongNm>강일동</adongNm>
                <stdrDt>2015-12-17</stdrDt>
            </item>
            <item>
                <ctprvnCd>11</ctprvnCd>
                <ctprvnNm>서울특별시</ctprvnNm>
                <signguCd>11740</signguCd>
                <signguNm>강동구</signguNm>
                <adongCd>1174055000</adongCd>
                <adongNm>고덕1동</adongNm>
                <stdrDt>2015-12-17</stdrDt>
            </item>
            ......
            <item>
                <ctprvnCd>11</ctprvnCd>
                <ctprvnNm>서울특별시</ctprvnNm>
                <signguCd>11740</signguCd>
                <signguNm>강동구</signguNm>
                <adongCd>1174062000</adongCd>
                <adongNm>천호3동</adongNm>
                <stdrDt>2015-12-17</stdrDt>
            </item>
        </items>
    </body>
</response>

  <response>
    <header>
        <description>소상공인시장진흥공단 상권정보 법정동 코드</description>
        <columns>시도코드,시도명,시군구코드,시군구명,법정동코드,법정동명,기준일자</columns>
        <resultCode>00</resultCode>
        <resultMsg>NORMAL SERVICE</resultMsg>
    </header>
    <body>
        <items>
            <item>
                <ctprvnCd>11</ctprvnCd>
                <ctprvnNm>서울특별시</ctprvnNm>
                <signguCd>11740</signguCd>
                <signguNm>강동구</signguNm>
                <ldongCd>1174011000</ldongCd>
                <ldongNm>강일동</ldongNm>
                <stdrDt>2015-12-17</stdrDt>
            </item>
            <item>
                <ctprvnCd>11</ctprvnCd>
                <ctprvnNm>서울특별시</ctprvnNm>
                <signguCd>11740</signguCd>
                <signguNm>강동구</signguNm>
                <ldongCd>1174010200</ldongCd>
                <ldongNm>고덕동</ldongNm>
                <stdrDt>2015-12-17</stdrDt>
            </item>
            ......
            <item>
                <ctprvnCd>11</ctprvnCd>
                <ctprvnNm>서울특별시</ctprvnNm>
                <signguCd>11740</signguCd>
                <signguNm>강동구</signguNm>
                <ldongCd>1174010900</ldongCd>
                <ldongNm>천호동</ldongNm>
                <stdrDt>2015-12-17</stdrDt>
            </item>
        </items>
    </body>
</response>

OpenAPI

행정동경계 조회 명세