OpenAPI 활용가이드

2023. 2

목     차

1. 서비스 개요	2

1.1. OpenAPI 서비스 개요	2

가. 배경 및 필요성	2

나. OpenAPI 서비스 설명	2

1.2. 기대효과	2

2. 서비스 사용	3

2.1. 서비스 Key 발급 및 활용	3

가. 서비스 Key 발급	3

나. 서비스 인증키 활용	5

3. 서비스 목록	5

4. 서비스 명세	6

4.1. 상가업소정보 서비스	6

가. 서비스 개요	6

나. 오퍼레이션 목록	7

1) 지정 상권조회 오퍼레이션 명세	8

2) 반경내 상권조회 오퍼레이션 명세	11

3) 사각형내 상권조회 오퍼레이션 명세	14

4) 행정구역 단위 상권조회 오퍼레이션 명세	17

5) 단일 상가업소 조회 오퍼레이션 명세	20

6) 건물단위 상가업소 조회 오퍼레이션 명세	25

7) 지번단위 상가업소 조회 오퍼레이션 명세	30

8) 행정동 단위 상가업소 조회 오퍼레이션 명세	35

9) 상권내 상가업소 조회 오퍼레이션 명세	41

10) 반경내 상가업소 조회 오퍼레이션 명세	48

11) 사각형내 상가업소 조회 오퍼레이션 명세	54

12) 다각형내 상가업소 조회 오퍼레이션 명세	60

13) 업종별 상가업소 조회 오퍼레이션 명세	66

14) 수정일자기준 상가업소 조회 오퍼레이션 명세	71

15) 상가업소정보 변경요청 오퍼레이션 명세	76

16) 상권정보 업종 대분류 조회 오퍼레이션 명세	78

17) 상권정보 업종 중분류 조회 오퍼레이션 명세	80

18) 상권정보 업종 소분류 조회 오퍼레이션 명세	82

19) 행정구역 조회 오퍼레이션 명세	85

가. 시도 조회	85

나. 시군구 조회	87

다. 행정동 조회	89

라. 법정동 조회	92

참조. 행정구역 조회	95

가. 시도	95

나. 시군구	96

1. 개 요

1.1 Open API 서비스 개요
가. 배경 및 필요성

1) 공공정보의 개방·활용에 대한 사회적 요구 확산

- 국가자원은 공공영역을 넘어 사적 영역의 다양한 사회적, 경제적 가치 창출에 활용될 수 있는 잠재성 내재

- 민간 영역의 자원과 융·복합을 통한 신규 비즈니스 창출이 용이한 형태의 국가 자원 개방·공유에 대한 수용 증대

- 공공데이터포털 목록 조회 서비스를 관련기관 및 민간에 활용 기회제공

2) OpenAPI기반으로 개발/제공함으로써 실시간 연계/활용이 가능하고 다른 정보와의 융합서비스 개발에 용의하게 정보 제공

나. OpenAPI 서비스 설명

공공데이터포털 목록 조회 서비스의 표준화된 제공으로 관련기관 및 민간에서 쉽게 활용할 수 있도록 개방한 공유서비스

1.2 기대효과

- 공공데이터포털 목록 조회 서비스 등을 일반 개발자에 공개하여 대국민의 접근성을 높이는 서비스

2. 서비스 사용

2.1 서비스 Key 발급 및 활용
가. 서비스 Key발급 (인증신청 및 발급)

1) 공유자원포털(http://data.go.kr) 활용자

- 활용신청하고자 하는 API를 검색하여 제목을 클릭한다

- 서비스정보와 상세기능 확인 후, 활용신청 버튼을 클릭한다.

- 활용신청하고자 하는 내역을 입력하고, 활용할 API를 선택하여 신청 버튼을 클릭한다.

-

나. 서비스 인증키 활용

1) REST 방식의 인증키 활용

http://apis.data.go.kr/B553077/api/open/sdsc2/오퍼레이션명/필수항목1.../필수항목n?ServiceKey=서비스키&옵션항목1=옵션항목1값......&옵션항목n=옵션항목값n

다. 서비스 인증키 확인

메뉴상에서 [마이페이지] [오픈API] [인증키발급현황]에서 조회 가능

3. 서비스 목록

순번	서비스명(국문)	서비스명(영문)
1	소상공인 상가업소 정보서비스	api/open/sdsc2

[마이페이지] [오픈API] [개발개정]에서 승인된 소상공인시장진흥공단_상가(상권)정보_API를 클릭하면 활용신청 상세기능정보가 보이며 미리보기로 확인이 가능

4. 서비스 명세
4.1 상가업소정보 서비스
가. 서비스 개요

서비스정보	서비스명(영문)	api/open/sdsc2
	서비스명(국문)	소상공인 상가업소 정보 서비스
	서비스설명	소상공인 상가업소 정보를 제공합니다.
서비스보안	서비스인증/권한	[ O ] serviceKey [ ] 인증서 (GPKI) [ ] Basic (ID/PW) [ ] 없음
	메시지레벨암호화	[ ] 전자서명 [ ] 암호화 [ O ] 없음
	전송레벨암호화	[ ] SSL [ O ] 없음
적용 기술 수준	인터페이스표준	[ ] SOAP 1.2 (RPC-Encoded, Document Literal, Document Literal Wrapped) [ O ] REST (GET, POST, PUT, DELETE) [ ] RSS1.0 [ ] RSS2.0 [ ] Atom 1.0 [ ] 기타
	교환데이터표준	[ O ] XML [ O ] JSON [ ] MIME [ ] MTOM
서비스 URL	개발환경	http://apis.data.go.kr/B553077/api/open/sdsc2
	운영환경	http://apis.data.go.kr/B553077/api/open/sdsc2
서비스 WADL	개발환경	N/A
	운영환경	N/A
서비스배포 정보	서비스버전	1.0
	서비스일자	2016-01-05		배포일자		2016-01-05
	서비스이력	2016-01-05 : 서비스 시작 2021-08-23 : 주요상권 업데이트 2023-02-20 : 주요상권 업데이트
메시지교환유형		[ O ] Request-Response [ ] Publish-Subscribe [ ] Fire-and-Forgot [ ] Notification
메시지로깅수준		성공	[O] Header [ ] Body	실패	[O] Header [ ] Body
서비스 제공자		소상공인시장진흥공단 1644-5302
데이터 갱신주기		분기별

나. 오퍼레이션 목록

일련번호	서비스명(국문)	오퍼레이션명(영문)	오퍼레이션명(국문)
1	소상공인 상가업소 정보 서비스	storeZoneOne	지정 상권조회
2		storeZoneInRadius	반경내 상권조회
3		storeZoneInRectangle	사각형내 상권조회
4		storeZoneInAdmi	행정구역 단위 상권조회
5		storeOne	단일 상가업소 조회
6		storeListInBuilding	건물단위 상가업소 조회
7		storeListInPnu	지번단위 상가업소 조회
8		storeListInDong	행정동 단위 상가업소 조회
9		storeListInArea	상권내 상가업소 조회
10		storeListInRadius	반경내 상가업소 조회
11		storeListInRectangle	사각형내 상가업소 조회
12		storeListInPolygon	다각형내 상가업소 조회
13		storeListInUpjong	업종별 상가업소 조회
14		storeListByDate	수정일자기준 상가업소 조회
15		reqStoreModify	상가업소정보 변경요청
16		largeUpjongList	상권정보업종 대분류 조회
17		middleUpjongList	상권정보업종 중분류 조회
18		smallUpjongList	상권정보업종 소분류 조회
19		baroApi	행정 경계 조회(명칭변경)

1) 지정 상권조회 오퍼레이션 명세

오퍼레이션 번호	1	오퍼레이션명(국문)	지정 상권조회
오퍼레이션 유형	조회	오퍼레이션명(영문)	storeZoneOne
오퍼레이션 설명	전국 약1200개 주요상권의 영역좌표를 조회하는 기능으로 지정된 상권번호에 해당하는 단일 상권정보를 조회한다.
Call Back URL	http://apis.data.go.kr/B553077/api/open/sdsc2/storeZoneOne
최대 메시지 사이즈	[ 1000 bytes ]
평균응답시간	[ 500 ms ]	초당 최대 트랜잭션	[ 30 tps ]

- 요청 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
key	상권번호	10	1	9174	조회 대상 상권의 상권번호
servicekey	서비스키	100	1	인증키(URL Encode)	서비스키
type	타입	4	0	xml	xml / json

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 응답 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
description	데이터 설명	30	1	소상공인...	데이터 설명
columns	컬럼	300	1	상권번호...	컬럼
resultCode	결과코드	2	1	00	결과코드
resultMsg	결과메세지	50	1	NORMAL SERVICE	결과메세지
trarNo	상권번호	10	1	9174	조회 대상 상권의 상권번호
mainTrarNm	상권명	50	1	인사동	상권이름
ctprvnCd	시도코드	2	1	11	광역시도코드
ctprvnNm	시도명	40	1	서울특별시	광역시도명
signguCd	시군구코드	4	1	11110	시군구코드
signguNm	시군구명	40	1	종로구	시군구명
trarArea	면적	6	1	226875	상권의 면적(㎡, 평방미터)
coordNum	좌표개수	8	1	21	상권영역 다각형의 좌표개수
coords	좌표값	4300	1	(아래참고)	상권영역 다각형의 좌표값 문자열
stdrDt	데이터기준일자	10	1	2020-12-31	데이터 배포일자

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

※ 좌표값은 WGS84 좌표계로 WKT(Well-known text) 포맷으로 MULTIPOLYGON((경도 위도, ...., 경도 위도)) 형식이다. 예시) MULTIPOLYGON ((127.039469 37.495145, 127.039189 37.495742, ......, 127.039469 37.495145))

- 요청/응답 메시지 예시

REST(URI)

http://apis.data.go.kr/B553077/api/open/sdsc2/storeZoneOne?key=9174&serviceKey=서비스인증키

응답 메시지

<response>

<header>

<description>소상공인시장진흥공단 주요상권</description>

<columns>상권번호,상권명,시도코드,시도명,시군구코드,시군구명,상권면적,좌표개수,좌표값,데이터기준일자</columns>

<resultCode>00</resultCode>

<resultMsg>NORMAL SERVICE</resultMsg>

</header>

<body>

<items>

<item>

<trarNo>9174</trarNo>

<mainTrarNm>인사동</mainTrarNm>

<ctprvnCd>11</ctprvnCd>

<ctprvnNm>서울특별시</ctprvnNm>

<signguCd>11110</signguCd>

<signguNm>종로구</signguNm>

<trarArea>226875</trarArea>

<coordNum>21</coordNum>

<coords>MULTIPOLYGON ((126.986059148338 37.5765234907315, 126.985943099285 37.5765933022497, 126.985003595935 37.5761584486461, 126.984321612825 37.5758475109755, 126.983682074805 37.5755861301059, 126.983073659879 37.5753743049793, 126.983019911215 37.5752819452711, 126.982977487921 37.5751693150508, 126.983105316596 37.573220945966, 126.983179233794 37.5718334337701, 126.983151246104 37.5705540242774, 126.983270142803 37.5703828545296, 126.983428633426 37.5703107995486, 126.985822713216 37.5702976242875, 126.98744706053 37.5703113418908, 126.987429831033 37.571653814357, 126.987588062984 37.5729782873447, 126.987372867362 37.5736044495484, 126.986789692656 37.5745999719345, 126.986195066917 37.5761631127724, 126.986059148338 37.5765234907315))</coords>

<stdrDt>2020-12-31</stdrDt>

</item>

</items>

</body>

</response>

2) 반경내 상권조회 오퍼레이션 명세

오퍼레이션 번호	2	오퍼레이션명(국문)	반경내 상권조회
오퍼레이션 유형	조회[목록]	오퍼레이션명(영문)	storeZoneInRadius
오퍼레이션 설명	전국 약1200개 주요상권의 영역좌표를 조회하는 기능으로 반경영역에 포함되는 상권데이터를 조회할 수 있다.
Call Back URL	http://apis.data.go.kr/B553077/api/open/sdsc2/storeZoneInRadius
최대 메시지 사이즈	[ 1000 bytes ]
평균응답시간	[ 500 ms ]	초당 최대 트랜잭션	[ 30 tps ]

- 요청 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
servicekey	서비스키	100	1	인증키(URL Encode)	공공데이터포털에서 발급받은 인증키
radius	반경	10	1	500	미터단위 (반경제한:2km)
cx	중심점 경도	22	1	127.03515915427266	반경 중심점 경도 값으로 WGS84좌표계
cy	중심점 위도	22	1	37.49736277789859	반경 중심점 위도 값으로 WGS84좌표계
type	타입	4	0	xml	xml / json

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 응답 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
description	데이터 설명	30	1	소상공인...	데이터 설명
columns	컬럼	300	1	상권번호...	컬럼
resultCode	결과코드	2	1	00	결과코드
resultMsg	결과메세지	50	1	NORMAL SERVICE	결과메세지
trarNo	상권번호	10	1	9307	조회 대상 상권의 상권번호
mainTrarNm	상권명	15	1	역삼역_1	상권이름
ctprvnCd	시도코드	2	1	11	광역시도코드
ctprvnNm	시도명	40	1	서울특별시	광역시도명
signguCd	시군구코드	4	1	11680	시군구코드
signguNm	시군구명	40	1	강남구	시군구명
trarArea	면적	6	1	292547	상권의 면적(㎡, 평방미터)
coordNum	좌표개수	8	1	10	상권영역 다각형의 좌표개수
coords	좌표값	4300	1	(아래참고)	상권영역 다각형의 좌표값 문자열
stdrDt	데이터기준일자	10	1	2020-12-31	데이터 배포일자

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

※ 좌표값은 WGS84 좌표계로 WKT(Well-known text) 포맷으로 MULTIPOLYGON((경도 위도, ...., 경도 위도)) 형식이다. 예시) MULTIPOLYGON ((127.039469 37.495145, 127.039189 37.495742, ......, 127.039469 37.495145))

- 요청/응답 메시지 예시

REST(URI)

http://apis.data.go.kr/B553077/api/open/sdsc2/storeZoneInRadius?radius=반경&cx=중심점경도&cy=중심점위도&serviceKey=서비스인증키

http://apis.data.go.kr/B553077/api/open/sdsc2/storeZoneInRadius?radius=500&cx=127.004528&cy=37.567538&serviceKey=서비스인증키

응답 메시지

<response>

<header>

<description>소상공인시장진흥공단 주요상권</description>

<columns>상권번호,상권명,시도코드,시도명,시군구코드,시군구명,상권면적,좌표개수,좌표값,데이터기준일자</columns>

<resultCode>00</resultCode>

<resultMsg>NORMAL SERVICE</resultMsg>

</header>

<body>

<items>

<item>

<trarNo>9307</trarNo>

<mainTrarNm>역삼역_1</mainTrarNm>

<ctprvnCd>11</ctprvnCd>

<ctprvnNm>서울특별시</ctprvnNm>

<signguCd>11680</signguCd>

<signguNm>강남구</signguNm>

<trarArea>292547</trarArea>

<coordNum>10</coordNum>

<coords>MULTIPOLYGON ((127.036815211166 37.5005428006801, 127.03667948655 37.5005068013092, 127.031261820465 37.4988234253835, 127.032188335121 37.4968770257367, 127.033476341605 37.4941826894817, 127.035195390987 37.4946957805607, 127.039052051268 37.4958929449688, 127.038193498687 37.4976771974333, 127.037221980889 37.4998038576353, 127.036815211166 37.5005428006801))</coords>

<stdrDt>2020-12-31</stdrDt>

</item>

<item>

<trarNo>9264</trarNo>

<mainTrarNm>한양시장</mainTrarNm>

<ctprvnCd>11</ctprvnCd>

<ctprvnNm>서울특별시</ctprvnNm>

<signguCd>11200</signguCd>

<signguNm>성동구</signguNm>

<trarArea>27474</trarArea>

<coordNum>13</coordNum>

<coords>MULTIPOLYGON ((127.039950763124 37.5612193717558, 127.039333898475 37.5611677647271, 127.039342173306 37.5607465487395, 127.03879037715 37.5606656357102, 127.038863754862 37.5602871961497, 127.04000126676 37.5603904434357, 127.040020862679 37.5599827385097, 127.040292526237 37.5600457186529, 127.039872996841 37.5585592205209, 127.04066231052 37.5583720047665, 127.041226602068 37.5606918681935, 127.039964672609 37.5607576092885, 127.039950763124 37.5612193717558))</coords>

<stdrDt>2020-12-31</stdrDt>

</item>

</items>

</body>

</response>

3) 사각형내 상권조회 오퍼레이션 명세

오퍼레이션 번호	3	오퍼레이션명(국문)	사각형내 상권조회
오퍼레이션 유형	조회[목록]	오퍼레이션명(영문)	storeZoneInRectangle
오퍼레이션 설명	전국 약1200개 주요상권의 영역좌표를 조회하는 기능으로 사각형영역에 포함되는 상권데이터를 조회할 수 있다.
Call Back URL	http://apis.data.go.kr/B553077/api/open/sdsc2/storeZoneInRectangle
최대 메시지 사이즈	[ 1000 bytes ]
평균응답시간	[ 500 ms ]	초당 최대 트랜잭션	[ 30 tps ]

- 요청 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
servicekey	서비스키	100	1	인증키(URL Encode)	공공데이터포털에서 발급받은 인증키
minx	서쪽 경도	22	1	126.678044073447	사각형 바운더리에서 서쪽 경도좌표값으로 WGS84 좌표계
miny	남쪽 위도	22	1	37.4487307296571	사각형 바운더리에서 남쪽 위도좌표값으로 WGS84 좌표계
maxx	동쪽 경도	22	1	126.67880642389	사각형 바운더리에서 동쪽 경도좌표값으로 WGS84 좌표계
maxy	북쪽 위도	22	1	37.4492574326684	사각형 바운더리에서 북쪽 위도좌표값으로 WGS84 좌표계
type	타입	4	0	xml	xml / json

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 응답 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
description	데이터설명	30	1	소상공인...	데이터 설명
resultCode	결과코드	2	1	00	결과코드
resultMsg	결과메세지	50	1	NORMAL SERVICE	결과메세지
trarNo	상권번호	10	1	41489	조회 대상 상권의 상권번호
mainTrarNm	상권명	15	1	통일종합시장	상권이름
ctprvnCd	시도코드	2	1	28	광역시도코드
ctprvnNm	시도명	40	1	인천광역시	광역시도명
signguCd	시군구코드	4	1	28170	시군구코드
signguNm	시군구명	40	1	미추홀구	시군구명
trarArea	면적	6	1	3327	상권의 면적(㎡, 평방미터)
coordNum	좌표개수	8	1	7	상권영역 다각형의 좌표개수
coords	좌표값	4300	1	(아래참고)	상권영역 다각형의 좌표값 문자열
stdrDt	데이터기준일자	10	1	2020-12-31	데이터 배포일자

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

※ 좌표값은 WGS84 좌표계로 WKT(Well-known text) 포맷으로 MULTIPOLYGON((경도 위도, ...., 경도 위도)) 형식이다. 예시) MULTIPOLYGON ((127.039469 37.495145, 127.039189 37.495742, ......, 127.039469 37.495145))

- 요청/응답 메시지 예시

REST(URI)

http://apis.data.go.kr/B553077/api/open/sdsc2/storeZoneInRectangle?minx=서쪽경도&miny=남쪽위도&maxx=동쪽경도&maxy=북쪽위도&serviceKey=서비스인증키

http://apis.data.go.kr/B553077/api/open/sdsc2/storeZoneInRectangle?minx=126.978020&miny=37.557825&maxx=126.987732&maxy=37.562022&serviceKey=서비스인증키

응답 메시지

<response>

<header>

<description>소상공인시장진흥공단 주요상권</description>

<resultCode>00</resultCode>

<resultMsg>NORMAL SERVICE</resultMsg>

</header>

<body>

<items>

<item>

<trarNo>41489</trarNo>

<mainTrarNm>통일종합시장</mainTrarNm>

<signguCd>28170</signguCd>

<signguNm>미추홀구</signguNm>

<coordNum>7</coordNum>

<coords>MULTIPOLYGON ((126.678080737177 37.4492493258884, 126.678042693527 37.4488096419853, 126.678058499836 37.4487793816842, 126.678754138777 37.4487386624191, 126.678761176885 37.4487482020259, 126.678807411696 37.4492012296178, 126.678080737177 37.4492493258884))</coords>

<stdrDt>2020-12-31</stdrDt>

</item>

<item>

<trarNo>9394</trarNo>

<mainTrarNm>장한평역_1</mainTrarNm>

<signguCd>11230</signguCd>

<signguNm>동대문구</signguNm>

<coordNum>28</coordNum>

<coords>MULTIPOLYGON ((127.06634405916 37.5637891358265, 127.066318588581 37.5637846448881, 127.066049446617 37.5634063766007, 127.065757641491 37.5629943328863, 127.065440334745 37.5625372527258, 127.065057882855 37.5619991176613, 127.06508046181 37.5619315311682, 127.06523586455 37.5616701598644, 127.065165027859 37.5615553218242, 127.066002474032 37.561439990024, 127.066772032365 37.5613517196347, 127.067567026783 37.5612318952881, 127.068098908665 37.5611527591758, 127.068141375735 37.5611797648948, 127.068161278968 37.5612878725471, 127.068246511311 37.5616752503777, 127.0682154245 37.5617180650471, 127.067890068153 37.561765550822, 127.068383130635 37.5625694062622, 127.06836056859 37.5626527607061, 127.067964612916 37.5628624650396, 127.067698245618 37.562427886968, 127.067545524103 37.5625135667851, 127.067090196943 37.5627818658489, 127.066830006556 37.5629329263316, 127.066524529701 37.5630704963776, 127.066822036023 37.5635253320813, 127.06634405916 37.5637891358265))</coords>

<stdrDt>2020-12-31</stdrDt>

</item>

</items>

</body>

</response>

4) 행정구역 단위 상권조회 오퍼레이션 명세

오퍼레이션 번호	4	오퍼레이션명(국문)	행정구역 단위 상권조회
오퍼레이션 유형	조회[목록]	오퍼레이션명(영문)	storeZoneInAdmi
오퍼레이션 설명	전국 약1200개 주요상권의 영역좌표를 조회하는 기능으로 중심점 좌표 포함되는 행정구역을 대상으로 상권데이터를 조회할 수 있다.
Call Back URL	http://apis.data.go.kr/B553077/api/open/sdsc2/storeZoneInAdmi
최대 메시지 사이즈	[ 1000 bytes ]
평균응답시간	[ 500 ms ]	초당 최대 트랜잭션	[ 30 tps ]

- 요청 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
servicekey	서비스키	100	1	인증키(URL Encode)	공공데이터포털에서 발급받은 인증키
divId	구분ID	8	1	ctprvnCd	시도는 ctprvnCd, 시군구는 signguCd, 행정동은 adongCd를 사용
key	행정구역코드	8	1	11	시도는 시도코드값, 시군구는 시군구코드값, 행정동은 행정동코드값을 사용
type	타입	4	0	xml	xml / json

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 응답 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
description	데이터설명	30	1	소상공인...	데이터설명
resultCode	결과코드	2	1	00	결과코드
resultMsg	결과메세지	50	1	NORMAL SERVICE	결과메세지
trarNo	상권번호	10	1	9307	조회 대상 상권의 상권번호
mainTrarNm	상권명	15	1	역삼역_1	상권이름
ctprvnCd	시도코드	2	1	11	광역시도코드
ctprvnNm	시도명	40	1	서울특별시	광역시도명
signguCd	시군구코드	4	1	11680	시군구코드
signguNm	시군구명	40	1	강남구	시군구명
trarArea	면적	6	1	292547	상권의 면적(㎡, 평방미터)
coordNum	좌표개수	8	1	10	상권영역 다각형의 좌표개수
coords	좌표값	4300	1	(아래참고)	상권영역 다각형의 좌표값 문자열
stdrDt	데이터기준일자	10	1	2020-12-31	데이터 배포일자

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

※ 좌표값은 WGS84 좌표계로 WKT(Well-known text) 포맷으로 MULTIPOLYGON((경도 위도, ...., 경도 위도)) 형식이다. 예시) MULTIPOLYGON ((127.039469 37.495145, 127.039189 37.495742, ......, 127.039469 37.495145))

- 요청/응답 메시지 예시

REST(URI)

http://apis.data.go.kr/B553077/api/open/sdsc2/storeZoneInAdmi?divId=구분ID&key=키값&serviceKey=서비스인증키

http://apis.data.go.kr/B553077/api/open/sdsc2/storeZoneInAdmi?divId=ctprvnCd&key=11&serviceKey=서비스인증키

응답 메시지

<response>

<header>

<description>소상공인시장진흥공단 주요상권</description>

<resultCode>00</resultCode>

<resultMsg>NORMAL SERVICE</resultMsg>

</header>

<body>

<items>

<item>

<trarNo>9307</trarNo>

<mainTrarNm>역삼역_1</mainTrarNm>

<ctprvnCd>11</ctprvnCd>

<ctprvnNm>서울특별시</ctprvnNm>

<signguCd>11680</signguCd>

<signguNm>강남구</signguNm>

<trarArea>292547</trarArea>

<coordNum>10</coordNum>

<coords>MULTIPOLYGON ((127.036815211166 37.5005428006801, 127.03667948655 37.5005068013092, 127.031261820465 37.4988234253835, 127.032188335121 37.4968770257367, 127.033476341605 37.4941826894817, 127.035195390987 37.4946957805607, 127.039052051268 37.4958929449688, 127.038193498687 37.4976771974333, 127.037221980889 37.4998038576353, 127.036815211166 37.5005428006801))</coords>

<stdrDt>2020-12-31</stdrDt>

</item>

</items>

</body>

</response>

5) 단일 상가업소 조회 오퍼레이션 명세

오퍼레이션 번호	5	오퍼레이션명(국문)	단일 상가업소 조회
오퍼레이션 유형	조회	오퍼레이션명(영문)	storeOne
오퍼레이션 설명	상가업소번호에 대한 업소정보를 조회 단일 업소정보를 출력이 필요한 경우를 위해 설계된 오퍼레이션
Call Back URL	http://apis.data.go.kr/B553077/api/open/sdsc2/storeOne
최대 메시지 사이즈	[ 1000 bytes ]
평균응답시간	[ 500 ms ]	초당 최대 트랜잭션	[ 30 tps ]

- 요청 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
servicekey	서비스키	100	1	인증키(URL Encode)	공공데이터포털에서 발급받은 인증키
key	상가업소번호	10	1	19911025	상가업소번호

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 응답 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
description	데이터설명	30	1	소상공인...	데이터설명
columns	컬럼	300	1	상가업소...	컬럼
stdrYm	기준년월	6	1	202106	기준년월
resultCode	결과코드	2	1	00	결과코드
resultMsg	결과메세지	50	1	NORMAL SERVICE	결과메세지
bizesId	상가업소번호	20	1	19911025	해당 상가업소에 부여된 일련번호
bizesNm	상호명	100	1	밀양돼지국밥	해당 상가업소의 상호명
brchNm	지점명	50	0		해당 상가업소가 지점인 경우 지점명
indsLclsCd	상권업종대분류코드	1	1	Q	해당 상가업소의 상권업종대분류코드
indsLclsNm	상권업종대분류명	40	1	음식	해당 상가업소의 상권업종대분류명
indsMclsCd	상권업종중분류코드	3	1	Q01	해당 상가업소의 상권업종중분류코드
indsMclsNm	상권업종중분류명	40	1	한식	해당 상가업소의 상권업종중분류명
indsSclsCd	상권업종소분류코드	6	1	Q01A05	해당 상가업소의 상권업종소분류코드
indsSclsNm	상권업종소분류명	40	1	해장국/감자탕	해당 상가업소의 상권업종소분류명
ksicCd	표준산업분류코드	5	0	I56111	해당 상가업소의 표준산업분류코드
ksicNm	표준산업분류명	40	0	한식 음식점업	해당 상가업소의 표준산업분류코드에 대한 명칭
ctprvnCd	시도코드	2	0	26	해당 상가업소의 시도 코드
ctprvnNm	시도명	20	0	부산광역시	해당 상가업소의 시도 명칭
signguCd	시군구코드	5	0	26500	해당 상가업소의 시군구 코드
signguNm	시군구명	20	0	수영구	해당 상가업소의 시군구 명칭
adongCd	행정동코드	10	0	2650077000	해당 상가업소의 행정동 코드
adongNm	행정동명	20	0	광안2동	해당 상가업소의 행정동 명칭
ldongCd	법정동코드	10	0	2650010400	해당 상가업소의 법정동 코드
ldongNm	법정동명	20	0	광안동	해당 상가업소의 법정동 명칭
lnoCd	PNU코드	19	0	2650010400201440053	해당 상가업소 지번주소에 해당하는 PNU코드
plotSctCd	대지구분코드	1	0	1	해당 상가업소 지번주소의 대지구분 코드(1:대지, 2:산)
plotSctNm	대지구분명	2	0	대지	해당 상가업소 지번주소의 대지구분 코드명(대지, 산)
lnoMnno	지번본번지	4	0	144	해당 상가업소 지번주소의 본번지
lnoSlno	지번부번지	4	0	53	해당 상가업소 지번주소의 부번지
lnoAdr	지번주소	100	0	부산광역시 수영구광안동 144-53	해당 상가업소 지번기준 전체주소
rdnmCd	도로명코드	12	0	265003138004	해당 상가업소 도로명주소 도로명코드
rdnm	도로명	30	0	부산광역시 수영구 광안로	해당 상가업소 도로명주소 도로명코드에 대한 명칭
bldMnno	건물본번지	5	0	17	해당 상가업소 도로명주소 기준 건물 본번지
bldSlno	건물부번지	5	0	1	해당 상가업소 도로명주소 기준 건물 부번지
bldMngNo	건물관리번호	25	0	2650010400101440053002840	해당 상가업소 도로명주소 기준 건물관리번호
bldNm	건물명	40	0		해당 상가업소 도로명주소 기준 건물명
rdnmAdr	도로명주소	100	0	부산광역시 수영구 광안로 17-1	해당 상가업소 도로명 주소기준 전체주소
oldZipcd	구우편번호	6	0	613100	해당 상가업소 구우편번호(개편전 우편번호)
newZipcd	신우편번호	5	0	48297	해당 상가업소 신우편번호(개편후 우편번호)
dongNo	동정보	10	0		해당 상가업소가 소재한 동정보
flrNo	층정보	10	0		해당 상가업소가 소재한 층정보
hoNo	호정보	10	0		해당 상가업소가 소재한 호정보
lon	경도	22	0	129.114882349766	해당 상가업소의 WGS84기준 위도 좌표값
lat	위도	22	0	35.1567548475294	해당 상가업소의 WGS84기준 위도 좌표값

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 요청/응답 메시지 예시

REST(URI)

http://apis.data.go.kr/B553077/api/open/sdsc2/storeOne?key=상가업소번호&serviceKey=서비스인증키

http://apis.data.go.kr/B553077/api/open/sdsc2/storeOne?key=19911025&serviceKey=서비스인증키

응답 메시지

<response>

<header>

<description>소상공인시장진흥공단 상가업소정보</description>

<column>상가업소번호,상호명,지점명,상권업종대분류코드,상권업종대분류명,                          상권업종중분류코드,상권업종중분류명,상권업종소분류코드,상권업                            종소분류명,표준산업분류코드,표준산업분류명,시도코드,시도명,시군                          구코드,시군구명,행정동코드,행정동명,법정동코드,법정동명,PNU코                           드,대지구분코드,대지구분명,지번본번지,지번부번지,지번주소,도로                            명코드,도로명,건물본번지,건물부번지,건물관리번                                           호,건물명,도로명주소,구우편번호,신우편번호,동정보,층정보,호정보,                          경도,위도</column>

<stdrYm>202106</stdrYm>

<resultCode>00</resultCode>

<resultMsg>NORMAL SERVICE</resultMsg>

</header>

<body>

<items>

<item>

<bizesId>19911025</bizesId>

<bizesNm>밀양돼지국밥</bizesNm>

<brchNm/>

<indsLclsCd>Q</indsLclsCd>

<indsLclsNm>음식</indsLclsNm>

<indsMclsCd>Q01</indsMclsCd>

<indsMclsNm>한식</indsMclsNm>

<indsSclsCd>Q01A05</indsSclsCd>

<indsSclsNm>해장국/감자탕</indsSclsNm>

<ksicCd>I56111</ksicCd>

<ksicNm>한식 음식점업</ksicNm>

<ctprvnCd>26</ctprvnCd>

<ctprvnNm>부산광역시</ctprvnNm>

<signguCd>26500</signguCd>

<signguNm>수영구</signguNm>

<adongCd>2650077000</adongCd>

<adongNm>광안2동</adongNm>

<ldongCd>2650010400</ldongCd>

<ldongNm>광안동</ldongNm>

<lnoCd>2650010400201440053</lnoCd>

<plotSctCd>1</plotSctCd>

<plotSctNm>대지</plotSctNm>

<lnoMnno>144</lnoMnno>

<lnoSlno>53</lnoSlno>

<lnoAdr>부산광역시 수영구 광안동 144-53</lnoAdr>

<rdnmCd>265003138004</rdnmCd>

<rdnm>부산광역시 수영구 광안로</rdnm>

<bldMnno>17</bldMnno>

<bldSlno>1</bldSlno>

<bldMngNo>2650010400101440053002840</bldMngNo>

<bldNm></bldNm>

<rdnmAdr>부산광역시 수영구 광안로 17-1</rdnmAdr>

<oldZipcd>613100</oldZipcd>

<newZipcd>48297</newZipcd>

<dongNo></dongNo>

<flrNo></flrNo>

<hoNo></hoNo>

<lon>129.114882349766</lon>

<lat>35.1567548475294</lat>

</items>

</body>

</response>

6) 건물단위 상가업소 조회 오퍼레이션 명세

오퍼레이션 번호	6	오퍼레이션명(국문)	건물 단위 상가업소 조회
오퍼레이션 유형	조회[목록]	오퍼레이션명(영문)	storeListInBuilding
오퍼레이션 설명	건물관리번호에 대한 업소정보를 조회 동일 건물내에 있는 업소목록이 필요한 경우를 위해 설계된 오퍼레이션 [사각형,다각형내 상가업소 조회 후 건물관리번호 획득]
Call Back URL	http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInBuilding
최대 메시지 사이즈	[ 1000 bytes ]
평균응답시간	[ 500 ms ]	초당 최대 트랜잭션	[ 30 tps ]

- 요청 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
servicekey	서비스키	100	1	인증키(URL Encode)	공공데이터포털에서 발급받은 인증키
key	건물관리번호	25	1	3017011200113530000022216	건물관리번호
indsLclsCd	상권업종대분류코드	1	0	Q	입력된 대분류 업종에 해당하는 것만 조회
indsMclsCd	상권업종중분류코드	3	0	Q12	입력된 중분류 업종에 해당하는 것만 조회
indsSclsCd	상권업종소분류코드	6	0	Q12A01	입력된 소분류 업종에 해당하는 것만 조회
numOfRows	페이지당 건수	4	0	100	최대 1000
pageNo	페이지 번호	4	0	1	현재 요청 페이지번호
type	타입	4	0	xml	xml / json

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 응답 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
description	데이터 설명	30	1	소상공인..	데이터 설명
columns	컬럼	300	1	상가업소..	컬럼
resultCode	결과코드	2	1	00	결과코드
resultMsg	결과메세지	50	1	NORMAL SERVICE	결과메세지
stdrYm	기준년월	6	1	202106	기준년월
bizesId	상가업소번호	20	1	10868815	해당 상가업소에 부여된 일련번호
bizesNm	상호명	100	1	땡땡땡다방	해당 상가업소의 상호명
brchNm	지점명	50	0	대전땡땡병원점	해당 상가업소가 지점인 경우 지점명
indsLclsCd	상권업종대분류코드	1	1	Q	해당 상가업소의 상권업종대분류코드
indsLclsNm	상권업종대분류명	40	1	음식	해당 상가업소의 상권업종대분류명
indsMclsCd	상권업종중분류코드	3	1	Q12	해당 상가업소의 상권업종중분류코드
indsMclsNm	상권업종중분류명	40	1	커피점/카페	해당 상가업소의 상권업종중분류명
indsSclsCd	상권업종소분류코드	6	1	Q12A01	해당 상가업소의 상권업종소분류코드
indsSclsNm	상권업종소분류명	40	1	커피전문점/카페/다방	해당 상가업소의 상권업종소분류명
ksicCd	표준산업분류코드	5	0	I56220	해당 상가업소의 표준산업분류코드
ksicNm	표준산업분류명	40	0	비알콜 음료점업	해당 상가업소의 표준산업분류코드에 대한 명칭
ctprvnCd	시도코드	2	0	30	해당 상가업소의 시도 코드
ctprvnNm	시도명	20	0	대전광역시	해당 상가업소의 시도 명칭
signguCd	시군구코드	5	0	30170	해당 상가업소의 시군구 코드
signguNm	시군구명	20	0	서구	해당 상가업소의 시군구 명칭
adongCd	행정동코드	10	0	3017064000	해당 상가업소의 행정동 코드
adongNm	행정동명	20	0	둔산2동	해당 상가업소의 행정동 명칭
ldongCd	법정동코드	10	0	3017011200	해당 상가업소의 법정동 코드
ldongNm	법정동명	20	0	둔산동	해당 상가업소의 법정동 명칭
lnoCd	PNU코드	19	0	3017011200213530000	해당 상가업소 지번주소에 해당하는 PNU코드
plotSctCd	대지구분코드	1	0	1	해당 상가업소 지번주소의 대지구분 코드(1:대지, 2:산)
plotSctNm	대지구분명	2	0	대지	해당 상가업소 지번주소의 대지구분 코드명(대지, 산)
lnoMnno	지번본번지	4	0	1353	해당 상가업소 지번주소의 본번지
lnoSlno	지번부번지	4	0		해당 상가업소 지번주소의 부번지
lnoAdr	지번주소	100	0	대전광역시 서구 둔산동 1353번지	해당 상가업소 지번기준 전체주소
rdnmCd	도로명코드	12	0	301704298326	해당 상가업소 도로명주소 도로명코드
rdnm	도로명	30	0	둔산로51번길	해당 상가업소 도로명주소 도로명코드에 대한 명칭
bldMnno	건물본번지	5	0	66	해당 상가업소 도로명주소 기준 건물 본번지
bldSlno	건물부번지	5	0	1	해당 상가업소 도로명주소 기준 건물 부번지
bldMngNo	건물관리번호	25	0	3017011200113530000022216	해당 상가업소 도로명주소 기준 건물관리번호
bldNm	건물명	40	0		해당 상가업소 도로명주소 기준 건물명
rdnmAdr	도로명주소	100	0	대전광역시 서구 둔산로51번길 66	해당 상가업소 도로명 주소기준 전체주소
oldZipcd	구우편번호	6	0	302830	해당 상가업소 구우편번호(개편전 우편번호)
newZipcd	신우편번호	5	0	35233	해당 상가업소 신우편번호(개편후 우편번호)
dongNo	동정보	10	0	가	해당 상가업소가 소재한 동정보
flrNo	층정보	10	0	1	해당 상가업소가 소재한 층정보
hoNo	호정보	10	0	101호	해당 상가업소가 소재한 호정보
lon	경도	22	0	127.380605	해당 상가업소의 WGS84기준 위도 좌표값
lat	위도	22	0	36.354149	해당 상가업소의 WGS84기준 위도 좌표값
numOfRows	페이지당 건수	4	0	20	한페이지 결과 수
pageNo	페이지 번호	4	0	1	현재 요청 페이지번호
totalCount	데이터 총 개수	10	0	1	데이터 총 개수

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 요청/응답 메시지 예시

REST(URI)

http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInBuilding?key=건물관리번호&serviceKey=서비스인증키

http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInBuilding?key=3017011200113530000022216&indsLclsCd=Q&indsMclsCd=Q12&indsSclsCd=Q12A01&serviceKey=서비스인증키

응답 메시지

<response>

<header>

<description>소상공인시장진흥공단 건물단위 상가업소정보</description>

<columns>상가업소번호,상호명,지점명,상권업종대분류코드,상권업종대분류명,상권업종중분류코드,상권업종중분류명,상권업종소분류코드,상권업종소분류명,표준산업분류코드,표준산업분류명,시도코드,시도명,시군구코드,시군구명,행정동코드,행정동명,법정동코드,법정동명,PNU코드,대지구분코드,대지구분명,지번본번지,지번부번지,지번주소,도로명코드,도로명,건물본번지,건물부번지,건물관리번호,건물명,도로명주소,구우편번호,신우편번호,동정보,층정보,호정보,경도,위도</columns>

<stdrYm>202106</stdrYm>

<resultCode>00</resultCode>

<resultMsg>NORMAL SERVICE</resultMsg>

</header>

<body>

<items>

<item>

<bizesId>16998056</bizesId>

<bizesNm>아이엠일리터</bizesNm>

<brchNm></brchNm>

<indsLclsCd>Q</indsLclsCd>

<indsLclsNm>음식</indsLclsNm>

<indsMclsCd>Q12</indsMclsCd>

<indsMclsNm>커피점/카페</indsMclsNm>

<indsSclsCd>Q12A01</indsSclsCd>

<indsSclsNm>커피전문점/카페/다방</indsSclsNm>

<ksicCd>I56220</ksicCd>

<ksicNm>비알콜 음료점업</ksicNm>

<ctprvnCd>30</ctprvnCd>

<ctprvnNm>대전광역시</ctprvnNm>

<signguCd>30170</signguCd>

<signguNm>서구</signguNm>

<adongCd>3017064000</adongCd>

<adongNm>둔산2동</adongNm>

<ldongCd>3017011200</ldongCd>

<ldongNm>둔산동</ldongNm>

<lnoCd>3017011200213530000</lnoCd>

<plotSctCd>1</plotSctCd>

<plotSctNm>대지</plotSctNm>

<lnoMnno>1353</lnoMnno>

<lnoSlno></lnoSlno>

<lnoAdr>대전광역시 서구 둔산동 1353</lnoAdr>

<rdnmCd>301704298326</rdnmCd>

<rdnm>대전광역시 서구 둔산로51번길</rdnm>

<bldMnno>66</bldMnno>

<bldSlno></bldSlno>

<bldMngNo>3017011200113530000022216</bldMngNo>

<bldNm></bldNm>

<rdnmAdr>대전광역시 서구 둔산로51번길 66</rdnmAdr>

<oldZipcd>302830</oldZipcd>

<newZipcd>35233</newZipcd>

<dongNo></dongNo>

<flrNo></flrNo>

<hoNo></hoNo>

<lon>127.380594798707</lon>

<lat>36.3541315618632</lat>

</item>

</items>

<numOfRows>20</numOfRows>

<pageNo>1</pageNo>

<totalCount>1</totalCount>

</body>

</response>

7) 지번단위 상가업소 조회 오퍼레이션 명세

오퍼레이션 번호	7	오퍼레이션명(국문)	지번 단위 상가업소 조회
오퍼레이션 유형	조회[목록]	오퍼레이션명(영문)	storeListInPnu
오퍼레이션 설명	PNU코드에 대한 업소정보를 조회 동일 지번에 있는 업소목록이 필요한 경우를 위해 설계된 오퍼레이션
Call Back URL	http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInPnu
최대 메시지 사이즈	[ 1000 bytes ]
평균응답시간	[ 500 ms ]	초당 최대 트랜잭션	[ 30 tps ]

- 요청 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
servicekey	서비스키	100	1	인증키(URL Encode)	공공데이터포털에서 발급받은 인증키
key	PNU코드	19	1	1123010300207370002	지번, PNU코드
indsLclsCd	상권업종대분류코드	1	0	D	입력된 대분류 업종에 해당하는 것만 조회
indsMclsCd	상권업종중분류코드	3	0	D10	입력된 중분류 업종에 해당하는 것만 조회
indsSclsCd	상권업종소분류코드	6	0	D10A05	입력된 소분류 업종에 해당하는 것만 조회
numOfRows	페이지당 건수	4	0	100	최대 1000
pageNo	페이지 번호	4	0	1	현재 요청 페이지번호
type	타입	4	0	xml	xml / json

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 응답 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
description	데이터 설명	30	1	소상공인...	데이터 설명
columns	컬럼	300	1	상가업소...	컬럼
stdrYm	기준년월	6	1	202106	기준년월
resultCode	결과코드	2	1	00	결과코드
resultMsg	결과메세지	50	1	NORMAL SERVICE	결과메세지
bizesId	상가업소번호	20	1	19908005	해당 상가업소에 부여된 일련번호
bizesNm	상호명	100	1	***장뇌산삼	해당 상가업소의 상호명
brchNm	지점명	50	0		해당 상가업소가 지점인 경우 지점명
indsLclsCd	상권업종대분류코드	1	1	D	해당 상가업소의 상권업종대분류코드
indsLclsNm	상권업종대분류명	40	1	소매	해당 상가업소의 상권업종대분류명
indsMclsCd	상권업종중분류코드	3	1	D10	해당 상가업소의 상권업종중분류코드
indsMclsNm	상권업종중분류명	40	1	건강/미용식품	해당 상가업소의 상권업종중분류명
indsSclsCd	상권업종소분류코드	6	1	D10A05	해당 상가업소의 상권업종소분류코드
indsSclsNm	상권업종소분류명	40	1	인삼제품판매	해당 상가업소의 상권업종소분류명
ksicCd	표준산업분류코드	5	0	G47216	해당 상가업소의 표준산업분류코드
ksicNm	표준산업분류명	40	0	건강보조식품 소매업	해당 상가업소의 표준산업분류코드에 대한 명칭
ctprvnCd	시도코드	2	0	11	해당 상가업소의 시도 코드
ctprvnNm	시도명	20	0	서울특별시	해당 상가업소의 시도 명칭
signguCd	시군구코드	5	0	11230	해당 상가업소의 시군구 코드
signguNm	시군구명	20	0	동대문구	해당 상가업소의 시군구 명칭
adongCd	행정동코드	10	0	1123054500	해당 상가업소의 행정동 코드
adongNm	행정동명	20	0	제기동	해당 상가업소의 행정동 명칭
ldongCd	법정동코드	10	0	1123010300	해당 상가업소의 법정동 코드
ldongNm	법정동명	20	0	제기동	해당 상가업소의 법정동 명칭
lnoCd	PNU코드 (지번코드)	19	0	1123010300207370002	해당 상가업소 지번주소에 해당하는 PNU코드
plotSctCd	대지구분코드	1	0	1	해당 상가업소 지번주소의 대지구분 코드(1:대지, 2:산)
plotSctNm	대지구분명	2	0	대지	해당 상가업소 지번주소의 대지구분 코드명(대지, 산)
lnoMnno	지번본번지	4	0	737	해당 상가업소 지번주소의 본번지
lnoSlno	지번부번지	4	0	2	해당 상가업소 지번주소의 부번지
lnoAdr	지번주소	100	0	서울특별시 동대문구 제기동 737-2	해당 상가업소 지번기준 전체주소
rdnmCd	도로명코드	12	0	112303105007	해당 상가업소 도로명주소 도로명코드
rdnm	도로명	30	0	서울특별시 동대문구 약령중앙로	해당 상가업소 도로명주소 도로명코드에 대한 명칭
bldMnno	건물본번지	5	0	68	해당 상가업소 도로명주소 기준 건물 본번지
bldSlno	건물부번지	5	0	1	해당 상가업소 도로명주소 기준 건물 부번지
bldMngNo	건물관리번호	25	0	1123010300107370002030949	해당 상가업소 도로명주소 기준 건물관리번호
bldNm	건물명	40	0	임광빌딩	해당 상가업소 도로명주소 기준 건물명
rdnmAdr	도로명주소	100	0	서울특별시 동대문구 약령중앙로 68-1	해당 상가업소 도로명 주소기준 전체주소
oldZipcd	구우편번호	6	0	130864	해당 상가업소 구우편번호(개편전 우편번호)
newZipcd	신우편번호	5	0	02478	해당 상가업소 신우편번호(개편후 우편번호)
dongNo	동정보	10	0		해당 상가업소가 소재한 동정보
flrNo	층정보	10	0	1	해당 상가업소가 소재한 층정보
hoNo	호정보	10	0		해당 상가업소가 소재한 호정보
lon	경도	22	0	127.037586228907	해당 상가업소의 WGS84기준 위도 좌표값
lat	위도	22	0	37.5843612854227	해당 상가업소의 WGS84기준 위도 좌표값
numOfRows	페이지당 건수	4	0	20	한페이지 결과 수
pageNo	페이지 번호	4	0	1	현재 요청 페이지번호
totalCount	데이터 총 개수	10	0	1	데이터 총 개수

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 요청/응답 메시지 예시

REST(URI)

http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInPnu?key=PNU코드&serviceKey=서비스인증키

http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInPnu?key=1123010300207370002&indsLclsCd=D&indsMclsCd=D10&indsSclsCd=D10A05&serviceKey=서비스인증키

응답 메시지

<response>

<header>

<description>소상공인시장진흥공단 지번단위 상가업소정보</description>

<columns>상가업소번호,... </columns>

<stdrYm>202106</stdrYm>

<resultCode>00</resultCode>

<resultMsg>NORMAL SERVICE</resultMsg>

</header>

<body>

<items>

<item>

<bizesId>19908005</bizesId>

<bizesNm>주봉산장뇌산삼</bizesNm>

<brchNm></brchNm>

<ctprvnCd>11</ctprvnCd>

<ctprvnNm>서울특별시</ctprvnNm>

<signguCd>11230</signguCd>

<signguNm>동대문구</signguNm>

<adongCd>1123054500</adongCd>

<adongNm>제기동</adongNm>

<ldongCd>1123010300</ldongCd>

<ldongNm>제기동</ldongNm>

<plotSctCd>1</plotSctCd>

<plotSctNm>대지</plotSctNm>

<lnoMnno>737</lnoMnno>

<lnoSlno>2</lnoSlno>

<lnoCd>1123010300207370002</lnoCd>

<lnoAdr>서울특별시 동대문구 제기동 737-2</lnoAdr>

<rdnmCd>112303105007</rdnmCd>

<rdnm>서울특별시 동대문구 약령중앙로</rdnm>

<bldMnno>68</bldMnno>

<bldSlno>1</bldSlno>

<bldMngNo>1123010300107370002030949</bldMngNo>

<bldNm></bldNm>

<dongNo></dongNo>

<flrNo>1</flrNo>

<hoNo></hoNo>

<rdnmAdr>서울특별시 동대문구 약령중앙로 68-1</rdnmAdr>

<oldZipcd>130864</oldZipcd>

<newZipcd>02478</newZipcd>

<lon>127.037586228907</lon>

<lat>37.5843612854227</lat>

<indsLclsCd>D</indsLclsCd>

<indsLclsNm>소매</indsLclsNm>

<indsMclsCd>D10</indsMclsCd>

<indsMclsNm>건강/미용식품</indsMclsNm>

<indsSclsCd>D10A05</indsSclsCd>

<indsSclsNm>인삼제품판매</indsSclsNm>

<ksicCd>G47216</ksicCd>

<ksicNm>건강보조식품 소매업</ksicNm>

</item>

</items>

<numOfRows>10</numOfRows>

<pageNo>1</pageNo>

<totalCount>1</totalCount>

</body>

</response>

8) 행정동 단위 상가업소 조회 오퍼레이션 명세

오퍼레이션 번호	8	오퍼레이션명(국문)	행정동 단위 상가업소 조회
오퍼레이션 유형	조회[목록]	오퍼레이션명(영문)	storeListInDong
오퍼레이션 설명	행정동코드에 대한 업소정보를 조회 동일한 행정동에 있는 업소목록이 필요한 경우를 위해 설계된 오퍼레이션
Call Back URL	http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInDong
최대 메시지 사이즈	[ 1000 bytes ]
평균응답시간	[ 500 ms ]	초당 최대 트랜잭션	[ 30 tps ]

- 요청 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
servicekey	서비스키	100	1	인증키(URL Encode)	공공데이터포털에서 발급받은 인증키
divId	구분ID	8	1	ctprvnCd	시도는 ctprvnCd, 시군구는 signguCd, 행정동은 adongCd를 사용
key	행정구역코드	8	1	11	시도는 시도코드값, 시군구는 시군구코드값, 행정동은 행정동코드값을 사용
indsLclsCd	상권업종 대분류코드	1	0	Q	입력된 대분류 업종에 해당하는 것만 조회
indsMclsCd	상권업종 중분류코드	3	0	Q12	입력된 중분류 업종에 해당하는 것만 조회
indsSclsCd	상권업종 소분류코드	6	0	Q12A01	입력된 소분류 업종에 해당하는 것만 조회
numOfRows	페이지당 건수	4	0	2	최대 1000
pageNo	페이지 번호	4	0	1	현재 요청 페이지번호
type	타입	4	0	xml	xml / json

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 응답 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
description	데이터 설명	30	1	소상공인...	데이터 설명
columns	컬럼	300	1	상가업소..	컬럼
stdrYm	기준년월	6	1	202106	기준년월
resultCode	결과코드	2	1	00	결과코드
resultMsg	결과메세지	50	1	NORMAL SERVICE	결과메세지
bizesId	상가업소번호	20	1	10142096	해당 상가업소에 부여된 일련번호
bizesNm	상호명	100	1	***스타	해당 상가업소의 상호명
brchNm	지점명	50	0	***서울	해당 상가업소가 지점인 경우 지점명
indsLclsCd	상권업종대분류코드	1	1	Q	해당 상가업소의 상권업종대분류코드
indsLclsNm	상권업종대분류명	40	1	음식	해당 상가업소의 상권업종대분류명
indsMclsCd	상권업종중분류코드	3	1	Q12	해당 상가업소의 상권업종중분류코드
indsMclsNm	상권업종중분류명	40	1	커피점/카페	해당 상가업소의 상권업종중분류명
indsSclsCd	상권업종소분류코드	6	1	Q12A01	해당 상가업소의 상권업종소분류코드
indsSclsNm	상권업종소분류명	40	1	커피전문점/카페/다방	해당 상가업소의 상권업종소분류명
ksicCd	표준산업분류코드	5	0	I56220	해당 상가업소의 표준산업분류코드
ksicNm	표준산업분류명	40	0	비알콜 음료점업	해당 상가업소의 표준산업분류코드에 대한 명칭
ctprvnCd	시도코드	2	0	11	해당 상가업소의 시도 코드
ctprvnNm	시도명	20	0	서울특별시	해당 상가업소의 시도 명칭
signguCd	시군구코드	5	0	11680	해당 상가업소의 시군구 코드
signguNm	시군구명	20	0	강남구	해당 상가업소의 시군구 명칭
adongCd	행정동코드	10	0	1168056500	해당 상가업소의 행정동 코드
adongNm	행정동명	20	0	청담동	해당 상가업소의 행정동 명칭
ldongCd	법정동코드	10	0	1168010400	해당 상가업소의 법정동 코드
ldongNm	법정동명	20	0	청담동	해당 상가업소의 법정동 명칭
lnoCd	PNU코드	19	0	1168010400200530007	해당 상가업소 지번주소에 해당하는 PNU코드
plotSctCd	대지구분코드	1	0	1	해당 상가업소 지번주소의 대지구분 코드(1:대지, 2:산)
plotSctNm	대지구분명	2	0	대지	해당 상가업소 지번주소의 대지구분 코드명(대지, 산)
lnoMnno	지번본번지	4	0	53	해당 상가업소 지번주소의 본번지
lnoSlno	지번부번지	4	0	7	해당 상가업소 지번주소의 부번지
lnoAdr	지번주소	100	0	서울특별시 강남구 청담동 53-7	해당 상가업소 지번기준 전체주소
rdnmCd	도로명코드	12	0	116802122002	해당 상가업소 도로명주소 도로명코드
rdnm	도로명	30	0	서울특별시 강남구 영동대로	해당 상가업소 도로명주소 도로명코드에 대한 명칭
bldMnno	건물본번지	5	0	737	해당 상가업소 도로명주소 기준 건물 본번지
bldSlno	건물부번지	5	0		해당 상가업소 도로명주소 기준 건물 부번지
bldMngNo	건물관리번호	25	0	1168010400100530007017901	해당 상가업소 도로명주소 기준 건물관리번호
bldNm	건물명	40	0	*****	해당 상가업소 도로명주소 기준 건물명
rdnmAdr	도로명주소	100	0	서울특별시 강남구 영동대로 737	해당 상가업소 도로명 주소기준 전체주소
oldZipcd	구우편번호	6	0	135952	해당 상가업소 구우편번호(개편전 우편번호)
newZipcd	신우편번호	5	0	06071	해당 상가업소 신우편번호(개편후 우편번호)
dongNo	동정보	10	0		해당 상가업소가 소재한 동정보
flrNo	층정보	10	0	1	해당 상가업소가 소재한 층정보
hoNo	호정보	10	0		해당 상가업소가 소재한 호정보
lon	경도	22	0	127.05416	해당 상가업소의 WGS84기준 위도 좌표값
lat	위도	22	0	37.52375	해당 상가업소의 WGS84기준 위도 좌표값
numOfRows	페이지당 건수	4	0	20	한페이지 결과 수
pageNo	페이지 번호	4	0	1	현재 요청 페이지번호
totalCount	데이터 총 개수	10	0	20478	데이터 총 개수

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 요청/응답 메시지 예시

REST(URI)

http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInDong?divId=구분ID&key=행정구역코드&serviceKey=서비스인증키

http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInDong?divId=ctprvnCd&key=11&indsMclsCd=Q12&indsSclsCd=Q12A01&divId=ctprvnCd&numOfRows=2&pageNo=1&type=xml&serviceKey=서비스인증키

응답 메시지

<response>

<header>

<description>소상공인시장진흥공단 행정동별 상가업소정보</description>

<columns>상가업소번호,상호명,지점명,상권업종대분류코드,상권업종대분류명,상권업종중분류코드,상권업종중분류명,상권업종소분류코드,상권업종소분류명,표준산업분류코드,표준산업분류명,시도코드,시도명,시군구코드,시군구명,행정동코드,행정동명,법정동코드,법정동명,PNU코드,대지구분코드,대지구분명,지번본번지,지번부번지,지번주소,도로명코드,도로명,건물본번지,건물부번지,건물관리번호,건물명,도로명주소,구우편번호,신우편번호,동정보,층정보,호정보,경도,위도</columns>

<stdrYm>202106</stdrYm>

<resultCode>00</resultCode>

<resultMsg>NORMAL SERVICE</resultMsg>

</header>

<body>

<items>

<item>

<bizesId>10142096</bizesId>

<bizesNm>카페비스타</bizesNm>

<brchNm>리베라호텔서울</brchNm>

<indsLclsCd>Q</indsLclsCd>

<indsLclsNm>음식</indsLclsNm>

<indsMclsCd>Q12</indsMclsCd>

<indsMclsNm>커피점/카페</indsMclsNm>

<indsSclsCd>Q12A01</indsSclsCd>

<indsSclsNm>커피전문점/카페/다방</indsSclsNm>

<ksicCd>I56220</ksicCd>

<ksicNm>비알콜 음료점업</ksicNm>

<ctprvnCd>11</ctprvnCd>

<ctprvnNm>서울특별시</ctprvnNm>

<signguCd>11680</signguCd>

<signguNm>강남구</signguNm>

<adongCd>1168056500</adongCd>

<adongNm>청담동</adongNm>

<ldongCd>1168010400</ldongCd>

<ldongNm>청담동</ldongNm>

<lnoCd>1168010400200530007</lnoCd>

<plotSctCd>1</plotSctCd>

<plotSctNm>대지</plotSctNm>

<lnoMnno>53</lnoMnno>

<lnoSlno>7</lnoSlno>

<lnoAdr>서울특별시 강남구 청담동 53-7</lnoAdr>

<rdnmCd>116802122002</rdnmCd>

<rdnm>서울특별시 강남구 영동대로</rdnm>

<bldMnno>737</bldMnno>

<bldSlno></bldSlno>

<bldMngNo>1168010400100530007017901</bldMngNo>

<bldNm>호텔리베라</bldNm>

<rdnmAdr>서울특별시 강남구 영동대로 737</rdnmAdr>

<oldZipcd>135952</oldZipcd>

<newZipcd>06071</newZipcd>

<dongNo></dongNo>

<flrNo>1</flrNo>

<hoNo></hoNo>

<lon>127.054169818602</lon>

<lat>37.5237556463502</lat>

</item>

<item>

<bizesId>10193213</bizesId>

<bizesNm>투썸커피</bizesNm>

<brchNm>청담CGV점</brchNm>

<indsLclsCd>Q</indsLclsCd>

<indsLclsNm>음식</indsLclsNm>

<indsMclsCd>Q12</indsMclsCd>

<indsMclsNm>커피점/카페</indsMclsNm>

<indsSclsCd>Q12A01</indsSclsCd>

<indsSclsNm>커피전문점/카페/다방</indsSclsNm>

<ksicCd>I56220</ksicCd>

<ksicNm>비알콜 음료점업</ksicNm>

<ctprvnCd>11</ctprvnCd>

<ctprvnNm>서울특별시</ctprvnNm>

<signguCd>11680</signguCd>

<signguNm>강남구</signguNm>

<adongCd>1168054500</adongCd>

<adongNm>압구정동</adongNm>

<ldongCd>1168010700</ldongCd>

<ldongNm>신사동</ldongNm>

<lnoCd>1168010700206510021</lnoCd>

<plotSctCd>1</plotSctCd>

<plotSctNm>대지</plotSctNm>

<lnoMnno>651</lnoMnno>

<lnoSlno>21</lnoSlno>

<lnoAdr>서울특별시 강남구 신사동 651-21</lnoAdr>

<rdnmCd>116802122001</rdnmCd>

<rdnm>서울특별시 강남구 도산대로</rdnm>

<bldMnno>323</bldMnno>

<bldSlno></bldSlno>

<bldMngNo>1168010700106510021027860</bldMngNo>

<bldNm>씨네시티빌딩</bldNm>

<rdnmAdr>서울특별시 강남구 도산대로 323</rdnmAdr>

<oldZipcd>135897</oldZipcd>

<newZipcd>06021</newZipcd>

<dongNo></dongNo>

<flrNo>1</flrNo>

<hoNo></hoNo>

<lon>127.036996269202</lon>

<lat>37.5228870114434</lat>

</item>

</items>

<numOfRows>2</numOfRows>

<pageNo>1</pageNo>

<totalCount>20478</totalCount>

</body>

</response>

9) 상권내 상가업소 조회 오퍼레이션 명세

오퍼레이션 번호	9	오퍼레이션명(국문)	상권내 상가업소 조회
오퍼레이션 유형	조회[목록]	오퍼레이션명(영문)	storeListInArea
오퍼레이션 설명	상권내 상가 업소정보를 조회 상권번호에 해당하는 업소목록이 필요한 경우를 위해 설계된 오퍼레이션, 상권에 포함되는 업소에는 상권번호 속성을 가지고 있음. 해당 상권번호와 일치하는 업소 정보를 조회할 수 있다. [상권번호 : 반경내 상권조회 후 상권번호 획득]
Call Back URL	http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInArea
최대 메시지 사이즈	[ 1000 bytes ]
평균응답시간	[ 500 ms ]	초당 최대 트랜잭션	[ 30 tps ]

- 요청 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
servicekey	서비스키	100	1	인증키(URL Encode)	공공데이터포털에서 발급받은 인증키
key	상권번호	10	1	1882	상가업소의 상권번호
indsLclsCd	상권업종 대분류코드	1	0	Q	입력된 대분류 업종에 해당하는 것만 조회
indsMclsCd	상권업종 중분류코드	3	0	Q12	입력된 중분류 업종에 해당하는 것만 조회
indsSclsCd	상권업종 소분류코드	6	0	Q12A01	입력된 소분류 업종에 해당하는 것만 조회
numOfRows	페이지당 건수	4	0	2	최대 1000
pageNo	페이지 번호	4	0	1	현재 요청 페이지번호
type	타입	4	0	xml	xml / json

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 응답 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
description	데이터 설명	30	1	소상공인...	데이터 설명
columns	컬럼	300	1	상가업소번호...	컬럼
stdrYm	기준년월	6	1	202106	기준년월
resultCode	결과코드	2	1	00	결과코드
resultMsg	결과메세지	50	1	NORMAL SERVICE	결과메세지
bizesId	상가업소번호	20	1	10904829	해당 상가업소에 부여된 일련번호
bizesNm	상호명	100	1	*****	해당 상가업소의 상호명
brchNm	지점명	50	0	강남점	해당 상가업소가 지점인 경우 지점명
indsLclsCd	상권업종대분류코드	1	1	Q	해당 상가업소의 상권업종대분류코드
indsLclsNm	상권업종대분류명	40	1	음식	해당 상가업소의 상권업종대분류명
indsMclsCd	상권업종중분류코드	3	1	Q12	해당 상가업소의 상권업종중분류코드
indsMclsNm	상권업종중분류명	40	1	커피점/카페	해당 상가업소의 상권업종중분류명
indsSclsCd	상권업종소분류코드	6	1	Q12A01	해당 상가업소의 상권업종소분류코드
indsSclsNm	상권업종소분류명	40	1	커피전문점/카페/다방	해당 상가업소의 상권업종소분류명
ksicCd	표준산업분류코드	5	0	I56220	해당 상가업소의 표준산업분류코드
ksicNm	표준산업분류명	40	0	비알콜 음료점업	해당 상가업소의 표준산업분류코드에 대한 명칭
ctprvnCd	시도코드	2	0	11	해당 상가업소의 시도 코드
ctprvnNm	시도명	20	0	서울특별시	해당 상가업소의 시도 명칭
signguCd	시군구코드	5	0	11680	해당 상가업소의 시군구 코드
signguNm	시군구명	20	0	강남구	해당 상가업소의 시군구 명칭
adongCd	행정동코드	10	0	1168064000	해당 상가업소의 행정동 코드
adongNm	행정동명	20	0	역삼1동	해당 상가업소의 행정동 명칭
ldongCd	법정동코드	10	0	1168010100	해당 상가업소의 법정동 코드
ldongNm	법정동명	20	0	역삼동	해당 상가업소의 법정동 명칭
lnoCd	PNU코드	19	0	1168010100207970022	해당 상가업소 지번주소에 해당하는 PNU코드
plotSctCd	대지구분코드	1	0	1	해당 상가업소 지번주소의 대지구분 코드(1:대지, 2:산)
plotSctNm	대지구분명	2	0	대지	해당 상가업소 지번주소의 대지구분 코드명(대지, 산)
lnoMnno	지번본번지	4	0	797	해당 상가업소 지번주소의 본번지
lnoSlno	지번부번지	4	0	22	해당 상가업소 지번주소의 부번지
lnoAdr	지번주소	100	0	서울특별시 강남구 역삼동 797-22	해당 상가업소 지번기준 전체주소
rdnmCd	도로명코드	12	0	116803121022	해당 상가업소 도로명주소 도로명코드
rdnm	도로명	30	0	서울특별시 강남구 논현로	해당 상가업소 도로명주소 도로명코드에 대한 명칭
bldMnno	건물본번지	5	0	319	해당 상가업소 도로명주소 기준 건물 본번지
bldSlno	건물부번지	5	0		해당 상가업소 도로명주소 기준 건물 부번지
bldMngNo	건물관리번호	25	0	1168010100107970022025616	해당 상가업소 도로명주소 기준 건물관리번호
bldNm	건물명	40	0	정유빌딩	해당 상가업소 도로명주소 기준 건물명
rdnmAdr	도로명주소	100	0	서울특별시 강남구 논현로 319	해당 상가업소 도로명 주소기준 전체주소
oldZipcd	구우편번호	6	0	135080	해당 상가업소 구우편번호(개편전 우편번호)
newZipcd	신우편번호	5	0	06257	해당 상가업소 신우편번호(개편후 우편번호)
dongNo	동정보	10	0		해당 상가업소가 소재한 동정보
flrNo	층정보	10	0	1	해당 상가업소가 소재한 층정보
hoNo	호정보	10	0		해당 상가업소가 소재한 호정보
lon	경도	22	0	127.03985	해당 상가업소의 WGS84기준 위도 좌표값
lat	위도	22	0	37.49377	해당 상가업소의 WGS84기준 위도 좌표값
numOfRows	페이지당 건수	4	0	20	한페이지 결과 수
pageNo	페이지 번호	4	0	1	현재 요청 페이지번호
totalCount	데이터 총 개수	10	0	20478	데이터 총 개수

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 요청/응답 메시지 예시

REST(URI)

http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInArea?key=상권번호&serviceKey=서비스인증키

http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInArea?key=1882&indsLclsCd=Q&indsMclsCd=Q12&indsSclsCd=Q12A01&numOfRows=2&pageNo=1&serviceKey=서비스인증키

응답 메시지

<response>

<header>

<description>소상공인시장진흥공단 주요상권내 상가업소정보</description>

<columns>상가업소번호,상호명,지점명,상권업종대분류코드,상권업종대분류명,상권업종중분류코드,상권업종중분류명,상권업종소분류코드,상권업종소분류명,표준산업분류코드,표준산업분류명,시도코드,시도명,시군구코드,시군구명,행정동코드,행정동명,법정동코드,법정동명,PNU코드,대지구분코드,대지구분명,지번본번지,지번부번지,지번주소,도로명코드,도로명,건물본번지,건물부번지,건물관리번호,건물명,도로명주소,구우편번호,신우편번호,동정보,층정보,호정보,경도,위도</columns>

<stdrYm>202106</stdrYm>

<resultCode>00</resultCode>

<resultMsg>NORMAL SERVICE</resultMsg>

</header>

<body>

<items>

<item>

<bizesId>10904829</bizesId>

<bizesNm>알라카르테</bizesNm>

<brchNm>강남점</brchNm>

<indsLclsCd>Q</indsLclsCd>

<indsLclsNm>음식</indsLclsNm>

<indsMclsCd>Q12</indsMclsCd>

<indsMclsNm>커피점/카페</indsMclsNm>

<indsSclsCd>Q12A01</indsSclsCd>

<indsSclsNm>커피전문점/카페/다방</indsSclsNm>

<ksicCd>I56220</ksicCd>

<ksicNm>비알콜 음료점업</ksicNm>

<ctprvnCd>11</ctprvnCd>

<ctprvnNm>서울특별시</ctprvnNm>

<signguCd>11680</signguCd>

<signguNm>강남구</signguNm>

<adongCd>1168064000</adongCd>

<adongNm>역삼1동</adongNm>

<ldongCd>1168010100</ldongCd>

<ldongNm>역삼동</ldongNm>

<lnoCd>1168010100207970022</lnoCd>

<plotSctCd>1</plotSctCd>

<plotSctNm>대지</plotSctNm>

<lnoMnno>797</lnoMnno>

<lnoSlno>22</lnoSlno>

<lnoAdr>서울특별시 강남구 역삼동 797-22</lnoAdr>

<rdnmCd>116803121022</rdnmCd>

<rdnm>서울특별시 강남구 논현로</rdnm>

<bldMnno>319</bldMnno>

<bldSlno></bldSlno>

<bldMngNo>1168010100107970022025616</bldMngNo>

<bldNm>정유빌딩</bldNm>

<rdnmAdr>서울특별시 강남구 논현로 319</rdnmAdr>

<oldZipcd>135080</oldZipcd>

<newZipcd>06257</newZipcd>

<dongNo></dongNo>

<flrNo>1</flrNo>

<hoNo></hoNo>

<lon>127.039858038296</lon>

<lat>37.4937792195489</lat>

</item>

<item>

<bizesId>11980828</bizesId>

<bizesNm>커피플라이</bizesNm>

<brchNm></brchNm>

<indsLclsCd>Q</indsLclsCd>

<indsLclsNm>음식</indsLclsNm>

<indsMclsCd>Q12</indsMclsCd>

<indsMclsNm>커피점/카페</indsMclsNm>

<indsSclsCd>Q12A01</indsSclsCd>

<indsSclsNm>커피전문점/카페/다방</indsSclsNm>

<ksicCd>I56220</ksicCd>

<ksicNm>비알콜 음료점업</ksicNm>

<ctprvnCd>11</ctprvnCd>

<ctprvnNm>서울특별시</ctprvnNm>

<signguCd>11680</signguCd>

<signguNm>강남구</signguNm>

<adongCd>1168064000</adongCd>

<adongNm>역삼1동</adongNm>

<ldongCd>1168010100</ldongCd>

<ldongNm>역삼동</ldongNm>

<lnoCd>1168010100207930007</lnoCd>

<plotSctCd>1</plotSctCd>

<plotSctNm>대지</plotSctNm>

<lnoMnno>793</lnoMnno>

<lnoSlno>7</lnoSlno>

<lnoAdr>서울특별시 강남구 역삼동 793-7</lnoAdr>

<rdnmCd>116804166216</rdnmCd>

<rdnm>서울특별시 강남구 도곡로17길</rdnm>

<bldMnno>29</bldMnno>

<bldSlno></bldSlno>

<bldMngNo>1168010100107930007025755</bldMngNo>

<bldNm></bldNm>

<rdnmAdr>서울특별시 강남구 도곡로17길 29</rdnmAdr>

<oldZipcd>135080</oldZipcd>

<newZipcd>06256</newZipcd>

<dongNo></dongNo>

<flrNo>1</flrNo>

<hoNo></hoNo>

<lon>127.036641544743</lon>

<lat>37.493275473994</lat>

</item>

</items>

<numOfRows>2</numOfRows>

<pageNo>1</pageNo>

<totalCount>17</totalCount>

</body>

</response>

10) 반경내 상가업소 조회 오퍼레이션 명세

오퍼레이션 번호	10	오퍼레이션명(국문)	반경내 상가업소 조회
오퍼레이션 유형	조회[목록]	오퍼레이션명(영문)	storeListInRadius
오퍼레이션 설명	반경내 상가 업소정보를 조회 반경안에 포함되는 업소목록이 필요한 경우를 위해 설계된 오퍼레이션, 업소의 경도, 위도 좌표가 입력된 반경에 포함되는 업소 정보를 조회할 수 있다.
Call Back URL	http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInRadius
최대 메시지 사이즈	[ 1000 bytes ]
평균응답시간	[ 500 ms ]	초당 최대 트랜잭션	[ 30 tps ]

- 요청 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
servicekey	서비스키	100	1	인증키(URL Encode)	공공데이터포털에서 발급받은 인증키
radius	반경	4	1	500	반경입력, (미터단위, 최대2000 미터)
cx	중심점 경도	22	1	126.573301	원형의 중심점의 경도값으로 WGS84 좌표계 사용
cy	중심점 위도	22	1	33.449826	원형의 중심점의 위도값으로 WGS84 좌표계 사용
indsLclsCd	상권업종 대분류코드	1	0	Q	입력된 대분류 업종에 해당하는 것만 조회
indsMclsCd	상권업종 중분류코드	3	0	Q12	입력된 중분류 업종에 해당하는 것만 조회
indsSclsCd	상권업종 소분류코드	6	0	Q12A01	입력된 소분류 업종에 해당하는 것만 조회
numOfRows	페이지당 건수	4	0	2	최대 1000
pageNo	페이지 번호	4	0	1	현재 요청 페이지번호
type	타입	4	0	xml	xml / json

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 응답 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
description	데이터 설명	30	1	소상공인시장진흥공단 반경내 상가업소정보	데이터 설명
columns	컬럼	300	1	상가업소번호...	컬럼
stdrYm	기준년월	6	1	202106	기준년월
resultCode	결과코드	2	1	00	결과코드
resultMsg	결과메세지	50	1	NORMAL SERVICE	결과메세지
bizesId	상가업소번호	20	1	12651699	해당 상가업소에 부여된 일련번호
bizesNm	상호명	100	1	닷카페	해당 상가업소의 상호명
brchNm	지점명	50	0		해당 상가업소가 지점인 경우 지점명
indsLclsCd	상권업종대분류코드	1	1	Q	해당 상가업소의 상권업종대분류코드
indsLclsNm	상권업종대분류명	40	1	음식	해당 상가업소의 상권업종대분류명
indsMclsCd	상권업종중분류코드	3	1	Q12	해당 상가업소의 상권업종중분류코드
indsMclsNm	상권업종중분류명	40	1	커피점/카페	해당 상가업소의 상권업종중분류명
indsSclsCd	상권업종소분류코드	6	1	Q12A01	해당 상가업소의 상권업종소분류코드
indsSclsNm	상권업종소분류명	40	1	커피전문점/카페/다방	해당 상가업소의 상권업종소분류명
ksicCd	표준산업분류코드	5	0	I56220	해당 상가업소의 표준산업분류코드
ksicNm	표준산업분류명	40	0	비알콜 음료점업	해당 상가업소의 표준산업분류코드에 대한 명칭
ctprvnCd	시도코드	2	0	50	해당 상가업소의 시도 코드
ctprvnNm	시도명	20	0	제주특별자치도	해당 상가업소의 시도 명칭
signguCd	시군구코드	5	0	50110	해당 상가업소의 시군구 코드
signguNm	시군구명	20	0	제주시	해당 상가업소의 시군구 명칭
adongCd	행정동코드	10	0	5011063000	해당 상가업소의 행정동 코드
adongNm	행정동명	20	0	아라동	해당 상가업소의 행정동 명칭
ldongCd	법정동코드	10	0	5011013600	해당 상가업소의 법정동 코드
ldongNm	법정동명	20	0	영평동	해당 상가업소의 법정동 명칭
lnoCd	PNU코드	19	0	5011013600221840000	해당 상가업소 지번주소에 해당하는 PNU코드
plotSctCd	대지구분코드	1	0	1	해당 상가업소 지번주소의 대지구분 코드(1:대지, 2:산)
plotSctNm	대지구분명	2	0	대지	해당 상가업소 지번주소의 대지구분 코드명(대지, 산)
lnoMnno	지번본번지	4	0	2184	해당 상가업소 지번주소의 본번지
lnoSlno	지번부번지	4	0		해당 상가업소 지번주소의 부번지
lnoAdr	지번주소	100	0	제주특별자치도 제주시 영평동 2184	해당 상가업소 지번기준 전체주소
rdnmCd	도로명코드	12	0	501103349191	해당 상가업소 도로명주소 도로명코드
rdnm	도로명	30	0	제주특별자치도 제주시 첨단로	해당 상가업소 도로명주소 도로명코드에 대한 명칭
bldMnno	건물본번지	5	0	216	해당 상가업소 도로명주소 기준 건물 본번지
bldSlno	건물부번지	5	0	19	해당 상가업소 도로명주소 기준 건물 부번지
bldMngNo	건물관리번호	25	0	5011013600121840000000001	해당 상가업소 도로명주소 기준 건물관리번호
bldNm	건물명	40	0	다음스페이스닷투	해당 상가업소 도로명주소 기준 건물명
rdnmAdr	도로명주소	100	0	제주특별자치도 제주시 첨단로 216-19	해당 상가업소 도로명 주소기준 전체주소
oldZipcd	구우편번호	6	0	690140	해당 상가업소 구우편번호(개편전 우편번호)
newZipcd	신우편번호	5	0	63309	해당 상가업소 신우편번호(개편후 우편번호)
dongNo	동정보	10	0		해당 상가업소가 소재한 동정보
flrNo	층정보	10	0	1	해당 상가업소가 소재한 층정보
hoNo	호정보	10	0		해당 상가업소가 소재한 호정보
lon	경도	22	0	126.570917983364	해당 상가업소의 WGS84기준 위도 좌표값
lat	위도	22	0	33.4524387197337	해당 상가업소의 WGS84기준 위도 좌표값
numOfRows	페이지당 건수	4	0	2	한페이지 결과 수
pageNo	페이지 번호	4	0	1	현재 요청 페이지번호
totalCount	데이터 총 개수	10	0	6	데이터 총 개수

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 요청/응답 메시지 예시

REST(URI)

http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInRadius?radius=반경&cx=중심경도&cy=중심위도&serviceKey=서비스인증키

http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInRadius?radius=500&cx=126.573301&cy=33.449826&indsLclsCd=Q&indsMclsCd=Q12&indsSclsCd=Q12A01&numOfRows=2&pageNo=1&type=xml&serviceKey=서비스인증키

응답 메시지

<response>

<header>

<description>소상공인시장진흥공단 반경내 상가업소정보</description>

<columns>상가업소번호,상호명,지점명,상권업종대분류코드,상권업종대분류명,상권업종중분류코드,상권업종중분류명,상권업종소분류코드,상권업종소분류명,표준산업분류코드,표준산업분류명,시도코드,시도명,시군구코드,시군구명,행정동코드,행정동명,법정동코드,법정동명,PNU코드,대지구분코드,대지구분명,지번본번지,지번부번지,지번주소,도로명코드,도로명,건물본번지,건물부번지,건물관리번호,건물명,도로명주소,구우편번호,신우편번호,동정보,층정보,호정보,경도,위도</columns>

<stdrYm>202106</stdrYm>

<resultCode>00</resultCode>

<resultMsg>NORMAL SERVICE</resultMsg>

</header>

<body>

<items>

<item>

<bizesId>12651699</bizesId>

<bizesNm>닷카페</bizesNm>

<brchNm></brchNm>

<indsLclsCd>Q</indsLclsCd>

<indsLclsNm>음식</indsLclsNm>

<indsMclsCd>Q12</indsMclsCd>

<indsMclsNm>커피점/카페</indsMclsNm>

<indsSclsCd>Q12A01</indsSclsCd>

<indsSclsNm>커피전문점/카페/다방</indsSclsNm>

<ksicCd>I56220</ksicCd>

<ksicNm>비알콜 음료점업</ksicNm>

<ctprvnCd>50</ctprvnCd>

<ctprvnNm>제주특별자치도</ctprvnNm>

<signguCd>50110</signguCd>

<signguNm>제주시</signguNm>

<adongCd>5011063000</adongCd>

<adongNm>아라동</adongNm>

<ldongCd>5011013600</ldongCd>

<ldongNm>영평동</ldongNm>

<plotSctCd>1</plotSctCd>

<plotSctNm>대지</plotSctNm>

<lnoMnno>2184</lnoMnno>

<lnoSlno></lnoSlno>

<lnoCd>5011013600221840000</lnoCd>

<lnoAdr>제주특별자치도 제주시 영평동 2184</lnoAdr>

<rdnmCd>501103349191</rdnmCd>

<rdnm>제주특별자치도 제주시 첨단로</rdnm>

<bldMnno>216</bldMnno>

<bldSlno>19</bldSlno>

<bldMngNo>5011013600121840000000001</bldMngNo>

<bldNm>다음스페이스닷투</bldNm>

<rdnmAdr>제주특별자치도 제주시 첨단로 216-19</rdnmAdr>

<oldZipcd>690140</oldZipcd>

<newZipcd>63309</newZipcd>

<dongNo/>

<flrNo>1</flrNo>

<hoNo/>

<lon>126.570917983364</lon>

<lat>33.4524387197337</lat>

</item>

<item>

<bizesId>16160609</bizesId>

<bizesNm>카페이안갤러리</bizesNm>

<brchNm>이안갤러리</brchNm>

<indsLclsCd>Q</indsLclsCd>

<indsLclsNm>음식</indsLclsNm>

<indsMclsCd>Q12</indsMclsCd>

<indsMclsNm>커피점/카페</indsMclsNm>

<indsSclsCd>Q12A01</indsSclsCd>

<indsSclsNm>커피전문점/카페/다방</indsSclsNm>

<ksicCd>I56220</ksicCd>

<ksicNm>비알콜 음료점업</ksicNm>

<ctprvnCd>50</ctprvnCd>

<ctprvnNm>제주특별자치도</ctprvnNm>

<signguCd>50110</signguCd>

<signguNm>제주시</signguNm>

<adongCd>5011063000</adongCd>

<adongNm>아라동</adongNm>

<ldongCd>5011013600</ldongCd>

<ldongNm>영평동</ldongNm>

<plotSctCd>1</plotSctCd>

<plotSctNm>대지</plotSctNm>

<lnoMnno>2170</lnoMnno>

<lnoSlno>1</lnoSlno>

<lnoCd>5011013600221700001</lnoCd>

<lnoAdr>제주특별자치도 제주시 영평동 2170-2</lnoAdr>

<rdnmCd>501103349191</rdnmCd>

<rdnm>제주특별자치도 제주시 첨단로</rdnm>

<bldMnno>213</bldMnno>

<bldSlno>4</bldSlno>

<bldMngNo>5011013600121700001000001</bldMngNo>

<bldNm>JDC엘리트빌딩</bldNm>

<rdnmAdr>제주특별자치도 제주시 첨단로 213-4</rdnmAdr>

<oldZipcd>690140</oldZipcd>

<newZipcd>63309</newZipcd>

<dongNo/>

<flrNo/>

<hoNo/>

<lon>126.572609938913</lon>

<lat>33.4528909727292</lat>

</item>

</items>

<numOfRows>2</numOfRows>

<pageNo>1</pageNo>

<totalCount>6</totalCount>

</body>

</response>

11) 사각형내 상가업소 조회 오퍼레이션 명세

오퍼레이션 번호	11	오퍼레이션명(국문)	사각형내 상가업소 조회
오퍼레이션 유형	조회[목록]	오퍼레이션명(영문)	storeListInRectangle
오퍼레이션 설명	사각형내 상가 업소정보를 조회 사각형안에 포함되는 업소목록이 필요한 경우를 위해 설계된 오퍼레이션, 업소의 경도, 위도 좌표가 입력된 사각형 바운더리 안에 포함되는 업소 정보를 조회할 수 있다.
Call Back URL	http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInRectangle
최대 메시지 사이즈	[ 1000 bytes ]
평균응답시간	[ 500 ms ]	초당 최대 트랜잭션	[ 30 tps ]

- 요청 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
servicekey	서비스키	100	1	인증키(URL Encode)	공공데이터포털에서 발급받은 인증키
minx	서쪽 경도	22	1	127.034113	사각형 바운더리에서 서쪽 경도좌표값으로 WGS84 좌표계 사용
miny	남쪽 위도	22	1	37.509715	사각형 바운더리에서 남쪽 경도좌표값으로 WGS84 좌표계 사용
maxx	동쪽 경도	22	1	127.035730	사각형 바운더리에서 동쪽 경도좌표값으로 WGS84 좌표계 사용
maxy	북쪽 위도	22	1	37.510824	사각형 바운더리에서 북쪽 경도좌표값으로 WGS84 좌표계 사용
indsLclsCd	상권업종 대분류코드	1	0	Q	입력된 대분류 업종에 해당하는 것만 조회
indsMclsCd	상권업종 중분류코드	3	0	Q12	입력된 중분류 업종에 해당하는 것만 조회
indsSclsCd	상권업종 소분류코드	6	0	Q12A01	입력된 소분류 업종에 해당하는 것만 조회
numOfRows	페이지당 건수	4	0	2	최대 1000
pageNo	페이지 번호	4	0	1	현재 요청 페이지번호
type	타입	4	0	xml	xml / json

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 응답 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
description	데이터 설명	30	1	소상공인...	데이터 설명
columns	컬럼	300	1	상가업소...	컬럼
stdrYm	기준년월	6	1	202106	기준년월
resultCode	결과코드	2	1	00	결과코드
resultMsg	결과메세지	50	1	NORMAL SERVICE	결과메세지
bizesId	상가업소번호	20	1	16582553	해당 상가업소에 부여된 일련번호
bizesNm	상호명	100	1	카페블랭킷	해당 상가업소의 상호명
brchNm	지점명	50	0	블랭킷	해당 상가업소가 지점인 경우 지점명
indsLclsCd	상권업종대분류코드	1	1	Q	해당 상가업소의 상권업종대분류코드
indsLclsNm	상권업종대분류명	40	1	음식	해당 상가업소의 상권업종대분류명
indsMclsCd	상권업종중분류코드	3	1	Q12	해당 상가업소의 상권업종중분류코드
indsMclsNm	상권업종중분류명	40	1	커피점/카페	해당 상가업소의 상권업종중분류명
indsSclsCd	상권업종소분류코드	6	1	Q12A01	해당 상가업소의 상권업종소분류코드
indsSclsNm	상권업종소분류명	40	1	커피전문점/카페/다방	해당 상가업소의 상권업종소분류명
ksicCd	표준산업분류코드	5	0	I56220	해당 상가업소의 표준산업분류코드
ksicNm	표준산업분류명	40	0	비알콜 음료점업	해당 상가업소의 표준산업분류코드에 대한 명칭
ctprvnCd	시도코드	2	0	11	해당 상가업소의 시도 코드
ctprvnNm	시도명	20	0	서울특별시	해당 상가업소의 시도 명칭
signguCd	시군구코드	5	0	11680	해당 상가업소의 시군구 코드
signguNm	시군구명	20	0	강남구	해당 상가업소의 시군구 명칭
adongCd	행정동코드	10	0	1168053100	해당 상가업소의 행정동 코드
adongNm	행정동명	20	0	논현2동	해당 상가업소의 행정동 명칭
ldongCd	법정동코드	10	0	1168010800	해당 상가업소의 법정동 코드
ldongNm	법정동명	20	0	논현동	해당 상가업소의 법정동 명칭
lnoCd	PNU코드	19	0	1168010800202240018	해당 상가업소 지번주소에 해당하는 PNU코드
plotSctCd	대지구분코드	1	0	1	해당 상가업소 지번주소의 대지구분 코드(1:대지, 2:산)
plotSctNm	대지구분명	2	0	대지	해당 상가업소 지번주소의 대지구분 코드명(대지, 산)
lnoMnno	지번본번지	4	0	224	해당 상가업소 지번주소의 본번지
lnoSlno	지번부번지	4	0	18	해당 상가업소 지번주소의 부번지
lnoAdr	지번주소	100	0	서울특별시 강남구 논현동 224-18	해당 상가업소 지번기준 전체주소
rdnmCd	도로명코드	12	0	116804166348	해당 상가업소 도로명주소 도로명코드
rdnm	도로명	30	0	서울특별시 강남구 봉은사로33길	해당 상가업소 도로명주소 도로명코드에 대한 명칭
bldMnno	건물본번지	5	0	37	해당 상가업소 도로명주소 기준 건물 본번지
bldSlno	건물부번지	5	0		해당 상가업소 도로명주소 기준 건물 부번지
bldMngNo	건물관리번호	25	0	1168010800102240018027094	해당 상가업소 도로명주소 기준 건물관리번호
bldNm	건물명	40	0	영일빌딩	해당 상가업소 도로명주소 기준 건물명
rdnmAdr	도로명주소	100	0	서울특별시 강남구 봉은사로33길 37	해당 상가업소 도로명 주소기준 전체주소
oldZipcd	구우편번호	6	0	135829	해당 상가업소 구우편번호(개편전 우편번호)
newZipcd	신우편번호	5	0	06107	해당 상가업소 신우편번호(개편후 우편번호)
dongNo	동정보	10	0		해당 상가업소가 소재한 동정보
flrNo	층정보	10	0	5	해당 상가업소가 소재한 층정보
hoNo	호정보	10	0		해당 상가업소가 소재한 호정보
lon	경도	22	0	127.034713424868	해당 상가업소의 WGS84기준 위도 좌표값
lat	위도	22	0	37.5104068138562	해당 상가업소의 WGS84기준 위도 좌표값
numOfRows	페이지당 건수	4	0	2	한페이지 결과 수
pageNo	페이지 번호	4	0	1	현재 요청 페이지번호
totalCount	데이터 총 개수	10	0	2	데이터 총 개수

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 요청/응답 메시지 예시

REST(URI)

http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInRectangle?minx=서쪽경도&miny=남쪽위도&maxx=동쪽경도&maxy북쪽위도&serviceKey=서비스인증키

http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInRectangle?minx=127.034113&miny=37.509715&maxx=127.035730&maxy=37.510824&indsLclsCd=Q&indsMclsCd=Q12&indsSclsCd=Q12A01&numOfRows=2&pageNo=1&type=xml&serviceKey=서비스인증키

응답 메시지

<response>

<header>

<description>소상공인시장진흥공단 사각형내 상가업소정보</description>

<columns>상가업소번호,상호명,지점명,상권업종대분류코드,상권업종대분류명,상권업종중분류코드,상권업종중분류명,상권업종소분류코드,상권업종소분류명,표준산업분류코드,표준산업분류명,시도코드,시도명,시군구코드,시군구명,행정동코드,행정동명,법정동코드,법정동명,PNU코드,대지구분코드,대지구분명,지번본번지,지번부번지,지번주소,도로명코드,도로명,건물본번지,건물부번지,건물관리번호,건물명,도로명주소,구우편번호,신우편번호,동정보,층정보,호정보,경도,위도</columns>

<stdrYm>202106</stdrYm>

<resultCode>00</resultCode>

<resultMsg>NORMAL SERVICE</resultMsg>

</header>

<body>

<items>

<item>

<bizesId>16582553</bizesId>

<bizesNm>카페블랭킷</bizesNm>

<brchNm>블랭킷</brchNm>

<indsLclsCd>Q</indsLclsCd>

<indsLclsNm>음식</indsLclsNm>

<indsMclsCd>Q12</indsMclsCd>

<indsMclsNm>커피점/카페</indsMclsNm>

<indsSclsCd>Q12A01</indsSclsCd>

<indsSclsNm>커피전문점/카페/다방</indsSclsNm>

<ksicCd>I56220</ksicCd>

<ksicNm>비알콜 음료점업</ksicNm>

<ctprvnCd>11</ctprvnCd>

<ctprvnNm>서울특별시</ctprvnNm>

<signguCd>11680</signguCd>

<signguNm>강남구</signguNm>

<adongCd>1168053100</adongCd>

<adongNm>논현2동</adongNm>

<ldongCd>1168010800</ldongCd>

<ldongNm>논현동</ldongNm>

<plotSctCd>1</plotSctCd>

<plotSctNm>대지</plotSctNm>

<lnoMnno>224</lnoMnno>

<lnoSlno>18</lnoSlno>

<lnoCd>1168010800202240018</lnoCd>

<lnoAdr>서울특별시 강남구 논현동 224-18</lnoAdr>

<rdnmCd>116804166348</rdnmCd>

<rdnm>서울특별시 강남구 봉은사로33길</rdnm>

<bldMnno>37</bldMnno>

<bldSlno></bldSlno>

<bldMngNo>1168010800102240018027094</bldMngNo>

<bldNm>영일빌딩</bldNm>

<rdnmAdr>서울특별시 강남구 봉은사로33길 37</rdnmAdr>

<oldZipcd>135829</oldZipcd>

<newZipcd>06107</newZipcd>

<dongNo/>

<flrNo>5</flrNo>

<hoNo/>

<lon>127.034713424868</lon>

<lat>37.5104068138562</lat>

</item>

<item>

<bizesId>16983142</bizesId>

<bizesNm>혼밥대왕</bizesNm>

<brchNm/>

<indsLclsCd>Q</indsLclsCd>

<indsLclsNm>음식</indsLclsNm>

<indsMclsCd>Q12</indsMclsCd>

<indsMclsNm>커피점/카페</indsMclsNm>

<indsSclsCd>Q12A01</indsSclsCd>

<indsSclsNm>커피전문점/카페/다방</indsSclsNm>

<ksicCd/>

<ksicNm/>

<ctprvnCd>11</ctprvnCd>

<ctprvnNm>서울특별시</ctprvnNm>

<signguCd>11680</signguCd>

<signguNm>강남구</signguNm>

<adongCd>1168053100</adongCd>

<adongNm>논현2동</adongNm>

<ldongCd>1168010800</ldongCd>

<ldongNm>논현동</ldongNm>

<lnoCd>1168010800202260000</lnoCd>

<plotSctCd>1</plotSctCd>

<plotSctNm>대지</plotSctNm>

<lnoMnno>226</lnoMnno>

<lnoSlno/>

<lnoAdr>서울특별시 강남구 논현동 226</lnoAdr>

<rdnmCd>116804166348</rdnmCd>

<rdnm>서울특별시 강남구 봉은사로33길</rdnm>

<bldMnno>34</bldMnno>

<bldSlno/>

<bldMngNo>1168010800102260000008146</bldMngNo>

<bldNm/>

<rdnmAdr>서울특별시 강남구 봉은사로33길 34</rdnmAdr>

<oldZipcd>135829</oldZipcd>

<newZipcd>06107</newZipcd>

<dongNo/>

<flrNo/>

<hoNo/>

<lon>127.035020997635</lon>

<lat>37.5102381267814</lat>

</item>

</items>

<numOfRows>2</numOfRows>

<pageNo>1</pageNo>

<totalCount>2</totalCount>

</body>

</response>

12) 다각형내 상가업소 조회 오퍼레이션 명세

오퍼레이션 번호	12	오퍼레이션명(국문)	다각형내 상가업소 조회
오퍼레이션 유형	조회[목록]	오퍼레이션명(영문)	storeListInPolygon
오퍼레이션 설명	다각형내 상가 업소정보를 조회 다각형안에 포함되는 업소목록이 필요한 경우를 위해 설계된 오퍼레이션, 업소의 경도, 위도 좌표가 입력된 다각형 영역 안에 포함되는 업소 정보를 조회할 수 있다. [업종코드 : 업종 대,중,소 분류 조회, 업종별 상가업소 조회 참고]
Call Back URL	http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInPolygon
최대 메시지 사이즈	[ 1000 bytes ]
평균응답시간	[ 500 ms ]	초당 최대 트랜잭션	[ 30 tps ]

- 요청 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
servicekey	서비스키	100	1	인증키(URL Encode)	공공데이터포털에서 발급받은 인증키
key	다각형 좌표값	4300	1	POLYGON ((126.9204728 35.1523226,126.9192728 35.1531925,126.9181257 35.1522507,126.9193808 35.1514315,126.9204728 35.1523226))	WKT 포맷 폴리곤 유형으로 POLYGON((경도 위도, 경도 위도, ...)) 형식으로 경도와 위도 사잉에는 공백이고 좌표값들은 콤마로 구분
indsLclsCd	상권업종 대분류코드	1	0	Q	입력된 대분류 업종에 해당하는 것만 조회
indsMclsCd	상권업종 중분류코드	3	0	Q09	입력된 중분류 업종에 해당하는 것만 조회
indsSclsCd	상권업종 소분류코드	6	0	Q09A01	입력된 소분류 업종에 해당하는 것만 조회
numOfRows	페이지당 건수	4	0	20	최대 1000
pageNo	페이지 번호	4	0	1	현재 요청 페이지번호
type	타입	4	0	xml	xml / json

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 응답 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
description	데이터 설명	30	1	소상공인...	데이터 설명
columns	컬럼	300	1	상가업소...	컬럼
stdrYm	기준년월	6	1	202106	기준년월
resultCode	결과코드	2	1	00	결과코드
resultMsg	결과메세지	50	1	NORMAL SERVICE	결과메세지
bizesId	상가업소번호	20	1	11832376	해당 상가업소에 부여된 일련번호
bizesNm	상호명	100	1	사랑PLUS	해당 상가업소의 상호명
brchNm	지점명	50	0		해당 상가업소가 지점인 경우 지점명
indsLclsCd	상권업종대분류코드	1	1	Q	해당 상가업소의 상권업종대분류코드
indsLclsNm	상권업종대분류명	40	1	음식	해당 상가업소의 상권업종대분류명
indsMclsCd	상권업종중분류코드	3	1	Q09	해당 상가업소의 상권업종중분류코드
indsMclsNm	상권업종중분류명	40	1	유흥주점	해당 상가업소의 상권업종중분류명
indsSclsCd	상권업종소분류코드	6	1	Q09A01	해당 상가업소의 상권업종소분류코드
indsSclsNm	상권업종소분류명	40	1	호프/맥주	해당 상가업소의 상권업종소분류명
ksicCd	표준산업분류코드	5	0	I56219	해당 상가업소의 표준산업분류코드
ksicNm	표준산업분류명	40	0	기타 주점업	해당 상가업소의 표준산업분류코드에 대한 명칭
ctprvnCd	시도코드	2	0	29	해당 상가업소의 시도 코드
ctprvnNm	시도명	20	0	광주광역시	해당 상가업소의 시도 명칭
signguCd	시군구코드	5	0	29110	해당 상가업소의 시군구 코드
signguNm	시군구명	20	0	동구	해당 상가업소의 시군구 명칭
adongCd	행정동코드	10	0	2911052500	해당 상가업소의 행정동 코드
adongNm	행정동명	20	0	충장동	해당 상가업소의 행정동 명칭
ldongCd	법정동코드	10	0	2911010700	해당 상가업소의 법정동 코드
ldongNm	법정동명	20	0	장동	해당 상가업소의 법정동 명칭
lnoCd	PNU코드	19	0	2911010700200160004	해당 상가업소 지번주소에 해당하는 PNU코드
plotSctCd	대지구분코드	1	0	1	해당 상가업소 지번주소의 대지구분 코드(1:대지, 2:산)
plotSctNm	대지구분명	2	0	대지	해당 상가업소 지번주소의 대지구분 코드명(대지, 산)
lnoMnno	지번본번지	4	0	16	해당 상가업소 지번주소의 본번지
lnoSlno	지번부번지	4	0	4	해당 상가업소 지번주소의 부번지
lnoAdr	지번주소	100	0	광주광역시 동구 장동 16-4	해당 상가업소 지번기준 전체주소
rdnmCd	도로명코드	12	0	291103162073	해당 상가업소 도로명주소 도로명코드
rdnm	도로명	30	0	광주광역시 동구 중앙로	해당 상가업소 도로명주소 도로명코드에 대한 명칭
bldMnno	건물본번지	5	0	234	해당 상가업소 도로명주소 기준 건물 본번지
bldSlno	건물부번지	5	0		해당 상가업소 도로명주소 기준 건물 부번지
bldMngNo	건물관리번호	25	0	2911010700100160004005727	해당 상가업소 도로명주소 기준 건물관리번호
bldNm	건물명	40	0		해당 상가업소 도로명주소 기준 건물명
rdnmAdr	도로명주소	100	0	광주광역시 동구 중앙로 234	해당 상가업소 도로명 주소기준 전체주소
oldZipcd	구우편번호	6	0	501060	해당 상가업소 구우편번호(개편전 우편번호)
newZipcd	신우편번호	5	0	61431	해당 상가업소 신우편번호(개편후 우편번호)
dongNo	동정보	10	0		해당 상가업소가 소재한 동정보
flrNo	층정보	10	0	1	해당 상가업소가 소재한 층정보
hoNo	호정보	10	0		해당 상가업소가 소재한 호정보
lon	경도	22	0	126.919121456599	해당 상가업소의 WGS84기준 위도 좌표값
lat	위도	22	0	35.1528985582098	해당 상가업소의 WGS84기준 위도 좌표값
numOfRows	페이지당 건수	4	0	20	한페이지 결과 수
pageNo	페이지 번호	4	0	1	현재 요청 페이지번호
totalCount	데이터 총 개수	10	0	6	데이터 총 개수

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 요청/응답 메시지 예시

REST(URI)

http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInPolygon?key=좌표값&serviceKey=서비스인증키

http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInPolygon?key=POLYGON ((126.9204728 35.1523226,126.9192728 35.1531925,126.9181257 35.1522507,126.9193808 35.1514315,126.9204728 35.1523226))&serviceKey=서비스인증키

응답 메시지

<response>

<header>

<description>소상공인시장진흥공단 다각형내 상가업소정보</description>

<columns>상가업소번호,상호명,지점명,상권업종대분류코드,상권업종대분류명,상권업종중분류코드,상권업종중분류명,상권업종소분류코드,상권업종소분류명,표준산업분류코드,표준산업분류명,시도코드,시도명,시군구코드,시군구명,행정동코드,행정동명,법정동코드,법정동명,PNU코드,대지구분코드,대지구분명,지번본번지,지번부번지,지번주소,도로명코드,도로명,건물본번지,건물부번지,건물관리번호,건물명,도로명주소,구우편번호,신우편번호,동정보,층정보,호정보,경도,위도</columns>

<stdrYm>202106</stdrYm>

<resultCode>00</resultCode>

<resultMsg>NORMAL SERVICE</resultMsg>

</header>

<body>

<items>

<item>

<bizesId>11832376</bizesId>

<bizesNm>사랑PLUS</bizesNm>

<brchNm/>

<indsLclsCd>Q</indsLclsCd>

<indsLclsNm>음식</indsLclsNm>

<indsMclsCd>Q09</indsMclsCd>

<indsMclsNm>유흥주점</indsMclsNm>

<indsSclsCd>Q09A01</indsSclsCd>

<indsSclsNm>호프/맥주</indsSclsNm>

<ksicCd>I56219</ksicCd>

<ksicNm>기타 주점업</ksicNm>

<ctprvnCd>29</ctprvnCd>

<ctprvnNm>광주광역시</ctprvnNm>

<signguCd>29110</signguCd>

<signguNm>동구</signguNm>

<adongCd>2911052500</adongCd>

<adongNm>충장동</adongNm>

<ldongCd>2911010700</ldongCd>

<ldongNm>장동</ldongNm>

<lnoCd>2911010700200160004</lnoCd>

<plotSctCd>1</plotSctCd>

<plotSctNm>대지</plotSctNm>

<lnoMnno>16</lnoMnno>

<lnoSlno>4</lnoSlno>

<lnoAdr>광주광역시 동구 장동 16-4</lnoAdr>

<rdnmCd>291103162073</rdnmCd>

<rdnm>광주광역시 동구 중앙로</rdnm>

<bldMnno>234</bldMnno>

<bldSlno/>

<bldMngNo>2911010700100160004005727</bldMngNo>

<bldNm/>

<rdnmAdr>광주광역시 동구 중앙로 234</rdnmAdr>

<oldZipcd>501060</oldZipcd>

<newZipcd>61431</newZipcd>

<dongNo/>

<flrNo>1</flrNo>

<hoNo/>

<lon>126.919121456599</lon>

<lat>35.1528985582098</lat>

</item>

<item>

<bizesId>12221779</bizesId>

<bizesNm>더플라워</bizesNm>

<brchNm/>

<indsLclsCd>D</indsLclsCd>

<indsLclsNm>소매</indsLclsNm>

<indsMclsCd>D02</indsMclsCd>

<indsMclsNm>선물/팬시/기념품</indsMclsNm>

<indsSclsCd>D02A02</indsSclsCd>

<indsSclsNm>꽃집/꽃배달</indsSclsNm>

<ksicCd>G47851</ksicCd>

<ksicNm>화초 및 산식물 소매업</ksicNm>

<ctprvnCd>29</ctprvnCd>

<ctprvnNm>광주광역시</ctprvnNm>

<signguCd>29110</signguCd>

<signguNm>동구</signguNm>

<adongCd>2911052500</adongCd>

<adongNm>충장동</adongNm>

<ldongCd>2911010700</ldongCd>

<ldongNm>장동</ldongNm>

<lnoCd>2911010700200020001</lnoCd>

<plotSctCd>1</plotSctCd>

<plotSctNm>대지</plotSctNm>

<lnoMnno>2</lnoMnno>

<lnoSlno>1</lnoSlno>

<lnoAdr>광주광역시 동구 장동 2-1</lnoAdr>

<rdnmCd>291103162073</rdnmCd>

<rdnm>광주광역시 동구 중앙로</rdnm>

<bldMnno>230</bldMnno>

<bldSlno/>

<bldMngNo>2911010700100030001005737</bldMngNo>

<bldNm/>

<rdnmAdr>광주광역시 동구 중앙로 230</rdnmAdr>

<oldZipcd>501060</oldZipcd>

<newZipcd>61431</newZipcd>

<dongNo/>

<flrNo/>

<hoNo/>

<lon>126.918751207566</lon>

<lat>35.1526789208362</lat>

</item>

</items>

<numOfRows>20</numOfRows>

<pageNo>1</pageNo>

<totalCount>26<totalCount>

</body>

</response>

13) 업종별 상가업소 조회 오퍼레이션 명세

오퍼레이션 번호	13	오퍼레이션명(국문)	업종별 상가업소 조회
오퍼레이션 유형	조회[목록]	오퍼레이션명(영문)	storeListInUpjong
오퍼레이션 설명	업종별 상가 업소정보를 조회 해당 업종에 대한 업소목록이 필요한 경우를 위해 설계된 오퍼레이션, 업종 기준으로 업소 정보를 조회할 수 있다.
Call Back URL	http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInUpjong
최대 메시지 사이즈	[ 1000 bytes ]
평균응답시간	[ 500 ms ]	초당 최대 트랜잭션	[ 30 tps ]

- 요청 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
servicekey	서비스키	100	1	인증키(URL Encode)	공공데이터포털에서 발급받은 인증키
divId	구분ID	10	1	indsLclsCd	대분류는 indsLclsCd, 중분류는 indsMclsCd, 소분류는 indsSclsCd를 사용
key	업종코드값	1, 3, 6	1	Q	대분류는 대분류코드값, 중분류는 중분류코드값, 소분류는 소분류코드값을 사용
numOfRows	페이지당 건수	4	0	1	최대 1000
pageNo	페이지 번호	4	0	1	현재 요청 페이지번호
type	타입	4	0	xml	xml / json

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 응답 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
description	데이터 설명	30	1	소상공인...	데이터 설명
columns	컬럼	300	1	상가업소..	컬럼
stdrYm	기준년월	6	1	202106	기준년월
resultCode	결과코드	2	1	00	결과코드
resultMsg	결과메세지	50	1	NORMAL SERVICE	결과메세지
bizesId	상가업소번호	20	1	10000982	해당 상가업소에 부여된 일련번호
bizesNm	상호명	100	1	이웃사촌	해당 상가업소의 상호명
brchNm	지점명	50	0		해당 상가업소가 지점인 경우 지점명
indsLclsCd	상권업종대분류코드	1	1	Q	해당 상가업소의 상권업종대분류코드
indsLclsNm	상권업종대분류명	40	1	음식	해당 상가업소의 상권업종대분류명
indsMclsCd	상권업종중분류코드	3	1	Q01	해당 상가업소의 상권업종중분류코드
indsMclsNm	상권업종중분류명	40	1	한식	해당 상가업소의 상권업종중분류명
indsSclsCd	상권업종소분류코드	6	1	Q01A01	해당 상가업소의 상권업종소분류코드
indsSclsNm	상권업종소분류명	40	1	한식/백반/한정식	해당 상가업소의 상권업종소분류명
ksicCd	표준산업분류코드	5	0	I56111	해당 상가업소의 표준산업분류코드
ksicNm	표준산업분류명	40	0	한식 음식점업	해당 상가업소의 표준산업분류코드에 대한 명칭
ctprvnCd	시도코드	2	0	45	해당 상가업소의 시도 코드
ctprvnNm	시도명	20	0	전라북도	해당 상가업소의 시도 명칭
signguCd	시군구코드	5	0	45111	해당 상가업소의 시군구 코드
signguNm	시군구명	20	0	전주시 완산구	해당 상가업소의 시군구 명칭
adongCd	행정동코드	10	0	4511170200	해당 상가업소의 행정동 코드
adongNm	행정동명	20	0	삼천2동	해당 상가업소의 행정동 명칭
ldongCd	법정동코드	10	0	4511113700	해당 상가업소의 법정동 코드
ldongNm	법정동명	20	0	삼천동1가	해당 상가업소의 법정동 명칭
lnoCd	PNU코드	19	0	4511113700206950005	해당 상가업소 지번주소에 해당하는 PNU코드
plotSctCd	대지구분코드	1	0	1	해당 상가업소 지번주소의 대지구분 코드(1:대지, 2:산)
plotSctNm	대지구분명	2	0	대지	해당 상가업소 지번주소의 대지구분 코드명(대지, 산)
lnoMnno	지번본번지	4	0	695	해당 상가업소 지번주소의 본번지
lnoSlno	지번부번지	4	0	5	해당 상가업소 지번주소의 부번지
lnoAdr	지번주소	100	0	전라북도 전주시 완산구 삼천동1가 695-5	해당 상가업소 지번기준 전체주소
rdnmCd	도로명코드	12	0	451114598396	해당 상가업소 도로명주소 도로명코드
rdnm	도로명	30	0	전라북도 전주시 완산구 하거마1길	해당 상가업소 도로명주소 도로명코드에 대한 명칭
bldMnno	건물본번지	5	0	32	해당 상가업소 도로명주소 기준 건물 본번지
bldSlno	건물부번지	5	0		해당 상가업소 도로명주소 기준 건물 부번지
bldMngNo	건물관리번호	25	0	4511113700106950005025264	해당 상가업소 도로명주소 기준 건물관리번호
bldNm	건물명	40	0		해당 상가업소 도로명주소 기준 건물명
rdnmAdr	도로명주소	100	0	전라북도 전주시 완산구 하거마1길 32	해당 상가업소 도로명 주소기준 전체주소
oldZipcd	구우편번호	6	0	560812	해당 상가업소 구우편번호(개편전 우편번호)
newZipcd	신우편번호	5	0	55088	해당 상가업소 신우편번호(개편후 우편번호)
dongNo	동정보	10	0		해당 상가업소가 소재한 동정보
flrNo	층정보	10	0		해당 상가업소가 소재한 층정보
hoNo	호정보	10	0		해당 상가업소가 소재한 호정보
lon	경도	22	0	127.117866794928	해당 상가업소의 WGS84기준 위도 좌표값
lat	위도	22	0	35.7930153087836	해당 상가업소의 WGS84기준 위도 좌표값
numOfRows	페이지당 건수	4	0	1	한페이지 결과 수
pageNo	페이지 번호	4	0	1	현재 요청 페이지번호
totalCount	데이터 총 개수	10	0	838060	데이터 총 개수

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 요청/응답 메시지 예시

REST(URI)

http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInUpjong?divId=구분ID&key=업종코드값&serviceKey=서비스인증키

http://apis.data.go.kr/B553077/api/open/sdsc2/storeListInUpjong?divId=indsLclsCd&key=Q&numOfRows=1&pageNo=1&type=xml&serviceKey=서비스인증키

응답 메시지

<response>

<header>

<description>소상공인시장진흥공단 주요상권내 상가업소정보</description>

<columns>상가업소번호,상호명,지점명,상권업종대분류코드,상권업종대분류명,상권업종중분류코드,상권업종중분류명,상권업종소분류코드,상권업종소분류명,표준산업분류코드,표준산업분류명,시도코드,시도명,시군구코드,시군구명,행정동코드,행정동명,법정동코드,법정동명,PNU코드,대지구분코드,대지구분명,지번본번지,지번부번지,지번주소,도로명코드,도로명,건물본번지,건물부번지,건물관리번호,건물명,도로명주소,구우편번호,신우편번호,동정보,층정보,호정보,경도,위도</columns>

<stdrYm>202106</stdrYm>

<resultCode>00</resultCode>

<resultMsg>NORMAL SERVICE</resultMsg>

</header>

<body>

<items>

<item>

<bizesId>10000982</bizesId>

<bizesNm>이웃사촌</bizesNm>

<brchNm/>

<indsLclsCd>Q</indsLclsCd>

<indsLclsNm>음식</indsLclsNm>

<indsMclsCd>Q01</indsMclsCd>

<indsMclsNm>한식</indsMclsNm>

<indsSclsCd>Q01A01</indsSclsCd>

<indsSclsNm>한식/백반/한정식</indsSclsNm>

<ksicCd>I56111</ksicCd>

<ksicNm>한식 음식점업</ksicNm>

<ctprvnCd>45</ctprvnCd>

<ctprvnNm>전라북도</ctprvnNm>

<signguCd>45111</signguCd>

<signguNm>전주시 완산구</signguNm>

<adongCd>4511170200</adongCd>

<adongNm>삼천2동</adongNm>

<ldongCd>4511113700</ldongCd>

<ldongNm>삼천동1가</ldongNm>

<lnoCd>4511113700206950005</lnoCd>

<plotSctCd>1</plotSctCd>

<plotSctNm>대지</plotSctNm>

<lnoMnno>695</lnoMnno>

<lnoSlno>5</lnoSlno>

<lnoAdr>전라북도 전주시 완산구 삼천동1가 695-5</lnoAdr>

<rdnmCd>451114598396</rdnmCd>

<rdnm>전라북도 전주시 완산구 하거마1길</rdnm>

<bldMnno>32</bldMnno>

<bldSlno/>

<bldMngNo>4511113700106950005025264</bldMngNo>

<bldNm/>

<rdnmAdr>전라북도 전주시 완산구 하거마1길 32</rdnmAdr>

<oldZipcd>560812</oldZipcd>

<newZipcd>55088</newZipcd>

<dongNo/>

<flrNo>1</flrNo>

<hoNo/>

<lon>127.117866794928</lon>

<lat>35.7930153087836</lat>

</item>

</items>

<numOfRows>1</numOfRows>

<pageNo>1</pageNo>

<totalCount>838060</totalCount>

</body>

</response>

14) 수정일자기준 상가업소 조회 오퍼레이션 명세

오퍼레이션 번호	14	오퍼레이션명(국문)	수정일자기준 상가업소 조회
오퍼레이션 유형	조회[목록]	오퍼레이션명(영문)	storeListByDate
오퍼레이션 설명	해당 수정일자를 기준으로 상가 업소정보를 조회 수정일자를 기준으로 신규, 수정 업소목록이 필요한 경우를 위해 설계된 오퍼레이션 (제공기준 : 영업중인 상가 업소정보)
Call Back URL	http://apis.data.go.kr/B553077/api/open/sdsc2/storeListByDate
최대 메시지 사이즈	[ 1000 bytes ]
평균응답시간	[ 500 ms ]	초당 최대 트랜잭션	[ 30 tps ]

- 요청 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
servicekey	서비스키	100	1	인증키(URL Encode)	공공데이터포털에서 발급받은 인증키
key	일자	8	1	20210602	일자(YYYYMMDD 형식, 예:20151202)
indsLclsCd	상권업종 대분류코드	1	0	Q	입력된 대분류 업종에 해당하는 것만 조회
indsMclsCd	상권업종 중분류코드	3	0	Q12	입력된 중분류 업종에 해당하는 것만 조회
indsSclsCd	상권업종 소분류코드	6	0	Q12A01	입력된 소분류 업종에 해당하는 것만 조회
numOfRows	페이지당 건수	4	0	1	최대 1000
pageNo	페이지 번호	4	0	1	현재 요청 페이지번호
type	타입	4	0	xml	xml / json

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 응답 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
description	데이터설명	30	1	소상공인...	데이터설명
columns	컬럼	300	1	상가업소...	컬럼
stdrYm	기준년월	6	1	202106	기준년월
resultCode	결과코드	2	1	00	결과코드
resultMsg	결과메세지	50	1	NORMAL SERVICE	결과메세지
bizesId	상가업소번호	20	1	12109863	해당 상가업소에 부여된 일련번호
bizesNm	상호명	100	1	우도엔젤	해당 상가업소의 상호명
brchNm	지점명	50	0		해당 상가업소가 지점인 경우 지점명
indsLclsCd	상권업종대분류코드	1	1	Q	해당 상가업소의 상권업종대분류코드
indsLclsNm	상권업종대분류명	40	1	음식	해당 상가업소의 상권업종대분류명
indsMclsCd	상권업종중분류코드	3	1	Q12	해당 상가업소의 상권업종중분류코드
indsMclsNm	상권업종중분류명	40	1	커피점/카페	해당 상가업소의 상권업종중분류명
indsSclsCd	상권업종소분류코드	6	1	Q12A01	해당 상가업소의 상권업종소분류코드
indsSclsNm	상권업종소분류명	40	1	커피전문점/카페/다방	해당 상가업소의 상권업종소분류명
ksicCd	표준산업분류코드	5	0		해당 상가업소의 표준산업분류코드
ksicNm	표준산업분류명	40	0		해당 상가업소의 표준산업분류코드에 대한 명칭
ctprvnCd	시도코드	2	0	50	해당 상가업소의 시도 코드
ctprvnNm	시도명	20	0	제주특별자치도	해당 상가업소의 시도 명칭
signguCd	시군구코드	5	0	50110	해당 상가업소의 시군구 코드
signguNm	시군구명	20	0	제주시	해당 상가업소의 시군구 명칭
adongCd	행정동코드	10	0	5011033000	해당 상가업소의 행정동 코드
adongNm	행정동명	20	0	우도면	해당 상가업소의 행정동 명칭
ldongCd	법정동코드	10	0	5011033021	해당 상가업소의 법정동 코드
ldongNm	법정동명	20	0	우도면	해당 상가업소의 법정동 명칭
lnoCd	PNU코드	19	0	5011033021200360000	해당 상가업소 지번주소에 해당하는 PNU코드
plotSctCd	대지구분코드	1	0	1	해당 상가업소 지번주소의 대지구분 코드(1:대지, 2:산)
plotSctNm	대지구분명	2	0	대지	해당 상가업소 지번주소의 대지구분 코드명(대지, 산)
lnoMnno	지번본번지	4	0	36	해당 상가업소 지번주소의 본번지
lnoSlno	지번부번지	4	0		해당 상가업소 지번주소의 부번지
lnoAdr	지번주소	100	0	제주특별자치도 제주시 우도면 연평리 36	해당 상가업소 지번기준 전체주소
rdnmCd	도로명코드	12	0	501104848460	해당 상가업소 도로명주소 도로명코드
rdnm	도로명	30	0	제주특별자치도 제주시 우도면 우도해안길	해당 상가업소 도로명주소 도로명코드에 대한 명칭
bldMnno	건물본번지	5	0	922	해당 상가업소 도로명주소 기준 건물 본번지
bldSlno	건물부번지	5	0		해당 상가업소 도로명주소 기준 건물 부번지
bldMngNo	건물관리번호	25	0	5011033021000360000046996	해당 상가업소 도로명주소 기준 건물관리번호
bldNm	건물명	40	0		해당 상가업소 도로명주소 기준 건물명
rdnmAdr	도로명주소	100	0	제주특별자치도 제주시 우도면 우도해안길 922	해당 상가업소 도로명 주소기준 전체주소
oldZipcd	구우편번호	6	0	695980	해당 상가업소 구우편번호(개편전 우편번호)
newZipcd	신우편번호	5	0	63365	해당 상가업소 신우편번호(개편후 우편번호)
dongNo	동정보	10	0		해당 상가업소가 소재한 동정보
flrNo	층정보	10	0		해당 상가업소가 소재한 층정보
hoNo	호정보	10	0		해당 상가업소가 소재한 호정보
lon	경도	22	0	126.964744494996	해당 상가업소의 WGS84기준 위도 좌표값
lat	위도	22	0	33.5128220846625	해당 상가업소의 WGS84기준 위도 좌표값
chgGb	변경구분	1	0	U	해당 상가업소정보의 데이터 변경 구분값 (생성:C, 수정:U중1)
chgDt	수정일자	8	0	20151202	일자(YYYYMMDD 형식, 예:20151202)
numOfRows	페이지당 건수	4	0	1	한페이지 결과 수
pageNo	페이지 번호	4	0	1	현재 요청 페이지번호
totalCount	데이터 총 개수	10	0	73	데이터 총 개수

- 요청/응답 메시지 예시

REST(URI)

http://apis.data.go.kr/B553077/api/open/sdsc2/storeListByDate?key=일자&serviceKey=서비스인증키

http://apis.data.go.kr/B553077/api/open/sdsc2/storeListByDate?key=20210602&indsLclsCd=Q&indsMclsCd=Q12&indsSclsCd=Q12A01&numOfRows=1&pageNo=1&type=xml&serviceKey=서비스인증키

응답 메시지

<response>

<header>

<description>소상공인시장진흥공단 상가업소정보</description>

<columns>상가업소번호,상호명,지점명,상권업종대분류코드,상권업종대분류명,상권업종중분류코드,상권업종중분류명,상권업종소분류코드,상권업종소분류명,표준산업분류코드,표준산업분류명,시도코드,시도명,시군구코드,시군구명,행정동코드,행정동명,법정동코드,법정동명,PNU코드,대지구분코드,대지구분명,지번본번지,지번부번지,지번주소,도로명코드,도로명,건물본번지,건물부번지,건물관리번호,건물명,도로명주소,구우편번호,신우편번호,동정보,층정보,호정보,경도,위도,변경구분</columns>

<stdrYm>202106</stdrYm>

<resultCode>00</resultCode>

<resultMsg>NORMAL SERVICE</resultMsg>

</header>

<body>

<items>

<item>

<bizesId>12109863</bizesId>

<bizesNm>우도엔젤</bizesNm>

<brchNm/>

<indsLclsCd>Q</indsLclsCd>

<indsLclsNm>음식</indsLclsNm>

<indsMclsCd>Q12</indsMclsCd>

<indsMclsNm>커피점/카페</indsMclsNm>

<indsSclsCd>Q12A01</indsSclsCd>

<indsSclsNm>커피전문점/카페/다방</indsSclsNm>

<ksicCd/>

<ksicNm/>

<ctprvnCd>50</ctprvnCd>

<ctprvnNm>제주특별자치도</ctprvnNm>

<signguCd>50110</signguCd>

<signguNm>제주시</signguNm>

<adongCd>5011033000</adongCd>

<adongNm>우도면</adongNm>

<ldongCd>5011033021</ldongCd>

<ldongNm>우도면</ldongNm>

<lnoCd>5011033021200360000</lnoCd>

<plotSctCd>1</plotSctCd>

<plotSctNm>대지</plotSctNm>

<lnoMnno>36</lnoMnno>

<lnoSlno/>

<lnoAdr>제주특별자치도 제주시 우도면 연평리 36</lnoAdr>

<rdnmCd>501104848460</rdnmCd>

<rdnm>제주특별자치도 제주시 우도면 우도해안길</rdnm>

<bldMnno>922</bldMnno>

<bldSlno/>

<bldMngNo>5011033021000360000046996</bldMngNo>

<bldNm/>

<rdnmAdr>제주특별자치도 제주시 우도면 우도해안길 922</rdnmAdr>

<oldZipcd>695980</oldZipcd>

<newZipcd>63365</newZipcd>

<dongNo/>

<flrNo/>

<hoNo/>

<lon>126.964744494996</lon>

<lat>33.5128220846625</lat>

<chgGb>U</chgGb>

</item>

</items>

<numOfRows>1</numOfRows>

<pageNo>1</pageNo>

<totalCount>73</totalCount>

</body>

</response>

15) 상가업소정보 변경요청 오퍼레이션 명세

오퍼레이션 번호	15	오퍼레이션명(국문)	상가업소정보 변경요청
오퍼레이션 유형	등록	오퍼레이션명(영문)	reqStoreModify
오퍼레이션 설명	상가업소명, 전화번호, 주소 등 상가업소 정보 정정을 요청하는 서비스 오류가 있는 업소 정보를 변경요청하는 오퍼레이션
Call Back URL	http://apis.data.go.kr/B553077/api/open/sdsc2/reqStoreModify
최대 메시지 사이즈	[ 1000 bytes ]
평균응답시간	[ 500 ms ]	초당 최대 트랜잭션	[ 30 tps ]

- 요청 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
servicekey	서비스키	100	1	인증키(URL Encode)	공공데이터포털에서 발급받은 인증키
bizesId	상가업소번호	20	1	10868815	변경 대상이 되는 상가업소번호로 해당 번호와 일치하는 업소가 있어야 변경요청이 수락 되어 진행된다.
bizesNm	상호명	100	1	백다방	변경 요청하는 상호명
brchNm	지점명	50	1	대전땡땡병원점	변경 요청하는 지점명
indsSclsCd	상권업종소분류코드	6	1	Q12A01	변경 요청하는 상권업종소분류코드
adongCd	행정동코드	10	1	3017064000	변경 요청하는 행정동 코드
lnoAdr	지번주소	100	1	대전광역시 서구 둔산동 1353번지	변경 요청하는 구주소
rdnmAdr	도로명주소	100	1	대전광역시 서구 둔산로51번길 66	변경 요청하는 도로명 주소
bldNm	건물명	40	1	임광빌딩	변경 요청하는 건물명
dongNo	동정보	10	1	가	변경 요청하는 동정보
flrNo	층정보	10	1	1	변경 요청하는 층정보
hoNo	호정보	10	1	101호	변경 요청하는 호정보
opbizDt	개업일자	8	1	20150101	개업일자를 입력
clbizDt	폐업일자	8	1	20151020	폐업일자를 입력
etcChgReqCnts	기타입력사항	1000	1	업종을 중국집에서 일식으로 변경해주세요.	기타 수정사항 텍스트 입력

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 응답 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
bizesId	상가업소번호	20	1	10868815	입력받은 상가업소번호를 되돌려 준다.
result	처리결과	2	1	00	정상인 경우 00. 그 외는 오류. header의 resultCode와 동일.
message	처리결과 메시지	100	1	정상적으로 업소변경 요청이 접수되었습니다.	처리 결과에 대한 텍스트

- 요청/응답 메시지 예시

REST(URI)

http://apis.data.go.kr/B553077/api/open/sdsc2/reqStoreModify?ServiceKey=서비스인증키&bizesId=상가업소번호&bizesNm=변경할업소명&dongNo=변경할동정보.......

http://apis.data.go.kr/B553077/api/open/sdsc2/reqStoreModify?ServiceKey=서비스인증키&bizesId=10868815&bizesNm=백다방&dongNo=101동....

응답 메시지

{

"message":"정상적으로 업소변경 요청이 접수 되었습니다.",

"result":"00",

"bizesId":"10868815“

}

16) 상권정보 업종 대분류 조회 오퍼레이션 명세

오퍼레이션 번호	21	오퍼레이션명(국문)	상권정보 업종 대분류 조회
오퍼레이션 유형	조회[목록]	오퍼레이션명(영문)	largeUpjongList
오퍼레이션 설명	상권정보 업종 대분류 코드를 조회
Call Back URL	http://apis.data.go.kr/B553077/api/open/sdsc2/largeUpjongList
최대 메시지 사이즈	[ 1000 bytes ]
평균응답시간	[ 500 ms ]	초당 최대 트랜잭션	[ 30 tps ]

- 요청 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
servicekey	서비스키	100	1	인증키(URL Encode)	공공데이터포털에서 발급받은 인증키
type	타입	4	0	xml	xml / json

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 응답 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
description	데이터 설명	30	1	소상공인시장진흥공단 상권정보 업종대분류 코드	데이터 설명
columns	컬럼	300	1	상권업종대분류..	컬럼
resultCode	결과코드	2	1	00	결과코드
resultMsg	결과메세지	50	1	NORMAL SERVICE	결과메세지
indsLclsCd	상권정보 업종 대분류 코드	1	1	A	상권정보 업종 대분류 코드
indsLclsNm	상권정보 업종 대분류 코드명	40	1	1차산업	상권정보 업종 대분류 코드명
stdrDt	데이터기준일자	10	1	2015-12-17	해당 상권업종 대분류 업종 데이터의 배포일자

- 요청/응답 메시지 예시

REST(URI)

http://apis.data.go.kr/B553077/api/open/sdsc2/largeUpjongList?serviceKey=서비스인증키

응답 메시지

<response>

<header>

<description>소상공인시장진흥공단 상권정보 업종대분류 코드</description>

<columns>상권업종대분류코드,상권업종대분류코드명,데이터기준일자                          </columns>

<resultCode>00</resultCode>

<resultMsg>NORMAL SERVICE</resultMsg>

</header>

<body>

<items>

<item>

<indsLclsCd>A</indsLclsCd>

<indsLclsNm>1차산업</indsLclsNm>

<stdrDt>2015-11-15</stdrDt>

</item>

<item>

<indsLclsCd>F</indsLclsCd>

<indsLclsNm>건설업</indsLclsNm>

<stdrDt>2015-11-15</stdrDt>

</item>

.....

<item>

<indsLclsCd>O</indsLclsCd>

<indsLclsNm>공공·국방·사회보장</indsLclsNm>

<stdrDt>2015-11-15</stdrDt>

</item>

<item>

<indsLclsCd>B</indsLclsCd>

<indsLclsNm>제조</indsLclsNm>

<stdrDt>2015-11-15</stdrDt>

</item>

<item>

<indsLclsCd>M</indsLclsCd>

<indsLclsNm>과학·기술</indsLclsNm>

<stdrDt>2015-11-15</stdrDt>

</item>

</items>

</body>

</response>

17) 상권정보 업종 중분류 조회 오퍼레이션 명세

오퍼레이션 번호	22	오퍼레이션명(국문)	상권정보 업종 중분류 조회
오퍼레이션 유형	조회[목록]	오퍼레이션명(영문)	middleUpjongList
오퍼레이션 설명	상권정보 업종 중분류 코드를 조회
Call Back URL	http://apis.data.go.kr/B553077/api/open/sdsc2/middleUpjongList
최대 메시지 사이즈	[ 1000 bytes ]
평균응답시간	[ 500 ms ]	초당 최대 트랜잭션	[ 30 tps ]

- 요청 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
servicekey	서비스키	100	1	인증키(URL Encode)	공공데이터포털에서 발급받은 인증키
indsLclsCd	상권정보 업종 대분류 코드	1	0	D	상권정보 업종 대분류 코드

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 응답 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
description	데이터 설명	30	1	소상공인...	데이터 설명
columns	컬럼	300	1	상권업종대분...	컬럼
resultCode	결과코드	2	1	00	결과코드
resultMsg	결과메세지	50	1	NORMAL SERVICE	결과메세지
indsLclsCd	상권정보 업종 대분류 코드	1	1	D	상권정보 업종 대분류 코드
indsLclsNm	상권정보 업종 대분류 코드명	40	1	소매	상권정보 업종 대분류 코드명
indsMclsCd	상권정보 업종 중분류 코드	3	1	Q15	상권정보 업종 중분류 코드
indsMclsNm	상권정보 업종 중분류 코드명	40	1	가구소매	상권정보 업종 중분류 코드명
stdrDt	데이터기준일자	10	1	2015-12-17	해당 상권업종 대분류 업종 데이터의 배포일자

- 요청/응답 메시지 예시

REST(URI)

http://apis.data.go.kr/B553077/api/open/sdsc2/middleUpjongList?indsLclsCd=업종대분류코드&serviceKey=서비스인증키

http://apis.data.go.kr/B553077/api/open/sdsc2/middleUpjongList?indsLclsCd=D&serviceKey=서비스인증키

응답 메시지

<response>

<header>

<description>소상공인시장진흥공단 상권정보 업종중분류 코드</description>

<columns>상권업종대분류코드,상권업종대분류코드명,상권업종중분류코드,상권업종중분류코드명,데이터기준일자</columns>

<resultCode>00</resultCode>

<resultMsg>NORMAL SERVICE</resultMsg>

</header>

<body>

<items>

<item>

<indsLclsCd>D</indsLclsCd>

<indsLclsNm>소매</indsLclsNm>

<indsMclsCd>D15</indsMclsCd>

<indsMclsNm>가구소매</indsMclsNm>

<stdrDt>2015-11-15</stdrDt>

</item>

<item>

<indsLclsCd>D</indsLclsCd>

<indsLclsNm>소매</indsLclsNm>

<indsMclsCd>D06</indsMclsCd>

<indsMclsNm>가방/신발/액세서리</indsMclsNm>

<stdrDt>2015-11-15</stdrDt>

</item>

<item>

<indsLclsCd>D</indsLclsCd>

<indsLclsNm>소매</indsLclsNm>

<indsMclsCd>D12</indsMclsCd>

<indsMclsNm>가전제품소매</indsMclsNm>

<stdrDt>2015-11-15</stdrDt>

</item>

...

</items>

</body>

</response>

18) 상권정보 업종 소분류 조회 오퍼레이션 명세

오퍼레이션 번호	23	오퍼레이션명(국문)	상권정보 업종 소분류 조회
오퍼레이션 유형	조회[목록]	오퍼레이션명(영문)	smallUpjongList
오퍼레이션 설명	상권정보 업종 소분류 코드를 조회
Call Back URL	http://apis.data.go.kr/B553077/api/open/sdsc2/smallUpjongList
최대 메시지 사이즈	[ 1000 bytes ]
평균응답시간	[ 500 ms ]	초당 최대 트랜잭션	[ 30 tps ]

- 요청 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
servicekey	서비스키	100	1	인증키(URL Encode)	공공데이터포털에서 발급받은 인증키
indsLclsCd	상권정보 업종 대분류 코드	1	0	Q	상권정보 업종 대분류 코드
indsMclsCd	상권정보 업종 중분류 코드	3	0	Q01	상권정보 업종 중분류 코드

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 응답 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
description	데이터 설명	30	1	소상공인시장진흥공단 상권정보 업종소분류 코드	데이터 설명
columns	컬럼	300	1	상권업종대분...	컬럼
resultCode	결과코드	2	1	00	결과코드
resultMsg	결과메세지	50	1	NORMAL SERVICE	결과메세지
indsLclsCd	상권정보 업종 대분류 코드	1	1	Q	상권정보 업종 대분류 코드
indsLclsNm	상권정보 업종 대분류 코드명	40	1	음식	상권정보 업종 대분류 코드명
indsMclsCd	상권정보 업종 중분류 코드	3	1	Q01	상권정보 업종 중분류 코드
indsMclsNm	상권정보 업종 중분류 코드명	40	1	한식	상권정보 업종 중분류 코드명
indsSclsCd	상권정보 업종 소분류 코드	6	1	Q01A02	상권정보 업종 소분류 코드
indsSclsNm	상권정보 업종 소분류 코드명	40	1	갈비/삼겹살	상권정보 업종 소분류 코드명
stdrDt	데이터기준일자	10	1	2015-12-17	해당 상권업종 대분류 업종 데이터의 배포일자
type	데이터 유형	4	0	xml	데이터유형(xml,json)으로 xml, json 포맷을 제공

- 요청/응답 메시지 예시

REST(URI)

http://apis.data.go.kr/B553077/api/open/sdsc2/smallUpjongList?indsLclsCd=업종대분류코드&indsMclsCd=업종중분류코드&serviceKey=서비스인증키

http://apis.data.go.kr/B553077/api/open/sdsc2/smallUpjongList?indsLclsCd=Q&indsMclsCd=Q01&serviceKey=서비스인증키

응답 메시지

<response>

<header>

<description>소상공인시장진흥공단 상권정보 업종소분류 코드</description>

<columns>상권업종대분류코드,상권업종대분류코드명,상권업종중분류코드,상권업종중분류코드명,상권업종소분류코드,상권업종소분류코드명,데이터기준일자</columns>

<resultCode>00</resultCode>

<resultMsg>NORMAL SERVICE</resultMsg>

</header>

<body>

<items>

<item>

<indsLclsCd>Q</indsLclsCd>

<indsLclsNm>음식</indsLclsNm>

<indsMclsCd>Q01</indsMclsCd>

<indsMclsNm>한식</indsMclsNm>

<indsSclsCd>Q01A02</indsSclsCd>

<indsSclsNm>갈비/삼겹살</indsSclsNm>

<stdrDt>2015-12-17</stdrDt>

</item>

<item>

<indsLclsCd>Q</indsLclsCd>

<indsLclsNm>음식</indsLclsNm>

<indsMclsCd>Q01</indsMclsCd>

<indsMclsNm>한식</indsMclsNm>

<indsSclsCd>Q01A03</indsSclsCd>

<indsSclsNm>곱창/양구이전문</indsSclsNm>

<stdrDt>2015-12-17</stdrDt>

</item>

</items>

</body>

</response>

19) 행정구역 조회 오퍼레이션 명세

가. 시도 조회

- 요청 URL

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

- 요청 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
servicekey	서비스키	100	1	인증키(URL Encode)	공공데이터포털에서 발급받은 인증키
resId	리소스 ID	4	1	dong	리소스에 대한 ID로 dong은 행정구역 리소스를 나타낸다.
catId	카테고리 ID	4	1	mega	리소스에서 카테고리를 구분하는 항목으로 행정구역 API에서는 mega는 시도에 해당한다.
type	데이터유형	4	0	xml	데이터유형(xml,json)으로 xml, json 포맷을 제공

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 응답 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
description	데이터 설명	30	1	소상공인...	데이터 설명
columns	컬럼	300	1	시도코드,시도명,기준일자	컬럼
resultCode	결과코드	2	1	00	결과코드
resultMsg	결과메세지	50	1	NORMAL SERVICE	결과메세지
ctprvnCd	시도코드	2	1	42	시도코드
ctprvnNm	시도명	10	1	강원도	시도명
stdrDt	데이터기준일자	10	1	2020-12-31	데이터 배포일자

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 요청/응답 메시지 예시

REST(URI)

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

응답 메시지

<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>

나. 시군구 조회

- 요청 URL

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

- 요청 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
resId	리소스 ID	4	1	dong	리소스에 대한 ID로 dong은 행정구역 리소스를 나타낸다.
catId	카테고리 ID	3	1	cty	리소스에서 카테고리를 구분하는 항목으로 행정구역 API에서는 cty는 시군구에 해당한다.
ctprvnCd	시도코드	2	1	11	시도코드 입력
serviceKey	서비스인증키	100	1	인증키(URL Encode)	공공데이터포털에서 받은 인증키
type	데이터유형	4	0	xml	데이터유형(xml,json)으로 xml, json 포맷을 제공

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 응답 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
description	데이터 설명	30	1	소상공인...	데이터 설명
columns	컬럼	300	1	시도코드..	컬럼
resultCode	결과코드	2	1	00	결과코드
resultMsg	결과메세지	50	1	NORMAL SERVICE	결과메세지
ctprvnCd	시도코드	2	1	11	시도코드
ctprvnNm	시도명	10	1	서울특별시	시도명
signguCd	시군구코드	5	1	11740	시군구코드
signguNm	시군구명	10	1	강동구	시군구명
stdrDt	데이터기준일자	10	1	2020-12-31	데이터 배포일자

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 요청/응답 메시지 예시

REST(URI)

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=서비스인증키

응답 메시지

<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>

다. 행정동 조회

- 요청 URL

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

- 요청 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
serviceKey	서비스인증키	100	1	인증키(URL Encode)	공공데이터 포털에서 받은 인증키
resId	리소스 ID	4	1	dong	리소스에 대한 ID로 dong은 행정구역 리소스를 나타낸다.
catId	카테고리 ID	4	1	admi	리소스에서 카테고리를 구분하는 항목으로 행정구역 API에서는 admi는 행정동에 해당한다.
signguCd	시군구코드	2	1	11740	시군구코드 입력
type	데이터유형	4	0	xml	데이터유형(xml,json)으로 xml, json 포맷을 제공

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 응답 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
description	데이터 설명	30	1	소상공인...	데이터 설명
columns	컬럼	300	1	시도코드..	컬럼
resultCode	결과코드	2	1	00	결과코드
resultMsg	결과메세지	50	1	NORMAL SERVICE	결과메세지
ctprvnCd	시도코드	2	1	11	시도코드
ctprvnNm	시도명	10	1	서울특별시	시도명
signguCd	시군구코드	5	1	11740	시군구코드
signguNm	시군구명	10	1	강동구	시군구명
adongCd	행정동코드	10	1	1174051500	행정동코드
adongNm	행정동명	10	1	강일동	행정동명
stdrDt	데이터기준일자	10	1	2015-12-17	데이터 배포일자

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 요청/응답 메시지 예시

REST(URI)

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=서비스인증키

응답 메시지

<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>

라. 법정동 조회

- 요청 URL

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

- 요청 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
serviceKey	서비스인증키	100	1	인증키(URL Encode)	공공데이터 포털에서 받은 인증키
resId	리소스 ID	4	1	dong	리소스에 대한 ID로 dong은 행정구역 리소스를 나타낸다.
catId	카테고리 ID	4	1	zone	리소스에서 카테고리를 구분하는 항목으로 행정구역 API에서는 zone은 법정동에 해당한다.
signguCd	시군구코드	2	1	11740	시군구코드 입력
type	데이터유형	4	0	xml	데이터유형(xml,json)으로 xml, json 포맷을 제공

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 응답 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
description	데이터 설명	30	1	소상공인...	데이터 설명
columns	컬럼	30	1	시도코드..	컬럼
resultCode	결과코드	2	1	00	결과코드
resultMsg	결과메세지	50	1	NORMAL SERVICE	결과메세지
ctprvnCd	시도코드	2	1	11	시도코드
ctprvnNm	시도명	10	1	서울특별시	시도명
signguCd	시군구코드	5	1	11740	시군구코드
signguNm	시군구명	10	1	강동구	시군구명
ldongCd	법정동코드	10	1	1174011000	법정동코드
ldongNm	법정동명	10	1	강일동	법정동명
stdrDt	데이터기준일자	10	1	2015-12-17	데이터 배포일자

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

- 요청/응답 메시지 예시

REST(URI)

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&signgu Cd=11740&serviceKey=서비스인증키

응답 메시지

<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>

참조. 행정구역 코드

소상공인 시장진흥공단에서 공개한 전국주요상권 및 상가업소 데이터에서 사용되고 있는 시도코드, 시군구코드에 대한 설명서이다. 전국주요상권에서는 상권의 중심에 해당하는 시도, 시군구를 속성을 포함하고 있으며, 상가업소 데이터에는 업소가 위치한 시도, 시군구, 행정동, 법정동 정보가 포함되어 있고 이에 대한 설명이다.

현행 행정구역 코드 체계는 행정구역 계층에 맞추어 시.도, 시.군.구, 읍.면.동 및 리로 구분하여 아라비아 숫자 10자리 종속적 분류체계를 따르고 있다. (N(2) N(3) N(3) N(2) - 시도는 2자리, 시군구는 5자리)

시도, 시군구 코드는 2023년 1월 기준 데이터로 아래와 같이 표로 직접 수록하였으며 API를 통해서 행정구역 코드 데이터를 구하는 방법도 “19) 행정구역 오퍼레이션 명세”에 설명하였다.

가. 시도

시도코드	시도명
11	서울특별시
26	부산광역시
27	대구광역시
28	인천광역시
29	광주광역시
30	대전광역시
31	울산광역시
36	세종특별자치시
41	경기도
42	강원도
43	충청북도
44	충청남도
45	전라북도
46	전라남도
47	경상북도
48	경상남도
50	제주특별자치도

나. 시군구

시도코드	시도명	시군구코드	시군구명
11	서울특별시	11110	종로구
11	서울특별시	11140	중구
11	서울특별시	11170	용산구
11	서울특별시	11200	성동구
11	서울특별시	11215	광진구
11	서울특별시	11230	동대문구
11	서울특별시	11260	중랑구
11	서울특별시	11290	성북구
11	서울특별시	11305	강북구
11	서울특별시	11320	도봉구
11	서울특별시	11350	노원구
11	서울특별시	11380	은평구
11	서울특별시	11410	서대문구
11	서울특별시	11440	마포구
11	서울특별시	11470	양천구
11	서울특별시	11500	강서구
11	서울특별시	11530	구로구
11	서울특별시	11545	금천구
11	서울특별시	11560	영등포구
11	서울특별시	11590	동작구
11	서울특별시	11620	관악구
11	서울특별시	11650	서초구
11	서울특별시	11680	강남구
11	서울특별시	11710	송파구
11	서울특별시	11740	강동구
26	부산광역시	26110	중구
26	부산광역시	26140	서구
26	부산광역시	26170	동구
26	부산광역시	26200	영도구
26	부산광역시	26230	부산진구
26	부산광역시	26260	동래구
26	부산광역시	26290	남구
26	부산광역시	26320	북구
26	부산광역시	26350	해운대구
26	부산광역시	26380	사하구
26	부산광역시	26410	금정구
26	부산광역시	26440	강서구
26	부산광역시	26470	연제구
26	부산광역시	26500	수영구
26	부산광역시	26530	사상구
26	부산광역시	26710	기장군
27	대구광역시	27110	중구
27	대구광역시	27140	동구
27	대구광역시	27170	서구
27	대구광역시	27200	남구
27	대구광역시	27230	북구
27	대구광역시	27260	수성구
27	대구광역시	27290	달서구
27	대구광역시	27710	달성군
28	인천광역시	28110	중구
28	인천광역시	28140	동구
28	인천광역시	28177	미추홀구
28	인천광역시	28185	연수구
28	인천광역시	28200	남동구
28	인천광역시	28237	부평구
28	인천광역시	28245	계양구
28	인천광역시	28260	서구
28	인천광역시	28710	강화군
28	인천광역시	28720	옹진군
29	광주광역시	29110	동구
29	광주광역시	29140	서구
29	광주광역시	29155	남구
29	광주광역시	29170	북구
29	광주광역시	29200	광산구
30	대전광역시	30110	동구
30	대전광역시	30140	중구
30	대전광역시	30170	서구
30	대전광역시	30200	유성구
30	대전광역시	30230	대덕구
31	울산광역시	31110	중구
31	울산광역시	31140	남구
31	울산광역시	31170	동구
31	울산광역시	31200	북구
31	울산광역시	31710	울주군
36	세종특별자치시	36110	세종특별자치시
41	경기도	41111	수원시 장안구
41	경기도	41113	수원시 권선구
41	경기도	41115	수원시 팔달구
41	경기도	41117	수원시 영통구
41	경기도	41131	성남시 수정구
41	경기도	41133	성남시 중원구
41	경기도	41135	성남시 분당구
41	경기도	41150	의정부시
41	경기도	41171	안양시 만안구
41	경기도	41173	안양시 동안구
41	경기도	41190	부천시
41	경기도	41210	광명시
41	경기도	41220	평택시
41	경기도	41250	동두천시
41	경기도	41271	안산시 상록구
41	경기도	41273	안산시 단원구
41	경기도	41281	고양시 덕양구
41	경기도	41285	고양시 일산동구
41	경기도	41287	고양시 일산서구
41	경기도	41290	과천시
41	경기도	41310	구리시
41	경기도	41360	남양주시
41	경기도	41370	오산시
41	경기도	41390	시흥시
41	경기도	41410	군포시
41	경기도	41430	의왕시
41	경기도	41450	하남시
41	경기도	41461	용인시 처인구
41	경기도	41463	용인시 기흥구
41	경기도	41465	용인시 수지구
41	경기도	41480	파주시
41	경기도	41500	이천시
41	경기도	41550	안성시
41	경기도	41570	김포시
41	경기도	41590	화성시
41	경기도	41610	광주시
41	경기도	41630	양주시
41	경기도	41650	포천시
41	경기도	41670	여주시
41	경기도	41800	연천군
41	경기도	41820	가평군
41	경기도	41830	양평군
42	강원도	42110	춘천시
42	강원도	42130	원주시
42	강원도	42150	강릉시
42	강원도	42170	동해시
42	강원도	42190	태백시
42	강원도	42210	속초시
42	강원도	42230	삼척시
42	강원도	42720	홍천군
42	강원도	42730	횡성군
42	강원도	42750	영월군
42	강원도	42760	평창군
42	강원도	42770	정선군
42	강원도	42780	철원군
42	강원도	42790	화천군
42	강원도	42800	양구군
42	강원도	42810	인제군
42	강원도	42820	고성군
42	강원도	42830	양양군
43	충청북도	43111	청주시 상당구
43	충청북도	43112	청주시 서원구
43	충청북도	43113	청주시 흥덕구
43	충청북도	43114	청주시 청원구
43	충청북도	43130	충주시
43	충청북도	43150	제천시
43	충청북도	43720	보은군
43	충청북도	43730	옥천군
43	충청북도	43740	영동군
43	충청북도	43750	진천군
43	충청북도	43760	괴산군
43	충청북도	43770	음성군
43	충청북도	43785	증평군
43	충청북도	43800	단양군
44	충청남도	44131	천안시 동남구
44	충청남도	44133	천안시 서북구
44	충청남도	44150	공주시
44	충청남도	44180	보령시
44	충청남도	44200	아산시
44	충청남도	44210	서산시
44	충청남도	44230	논산시
44	충청남도	44250	계룡시
44	충청남도	44270	당진시
44	충청남도	44710	금산군
44	충청남도	44760	부여군
44	충청남도	44770	서천군
44	충청남도	44790	청양군
44	충청남도	44800	홍북읍
44	충청남도	44800	홍성군
44	충청남도	44810	예산군
44	충청남도	44825	태안군
45	전라북도	45111	전주시 완산구
45	전라북도	45113	전주시 덕진구
45	전라북도	45130	군산시
45	전라북도	45140	익산시
45	전라북도	45180	정읍시
45	전라북도	45190	남원시
45	전라북도	45210	김제시
45	전라북도	45710	완주군
45	전라북도	45720	진안군
45	전라북도	45730	무주군
45	전라북도	45740	장수군
45	전라북도	45750	임실군
45	전라북도	45770	순창군
45	전라북도	45790	고창군
45	전라북도	45800	부안군
46	전라남도	46110	목포시
46	전라남도	46130	여수시
46	전라남도	46150	순천시
46	전라남도	46170	나주시
46	전라남도	46230	광양시
46	전라남도	46710	담양군
46	전라남도	46720	곡성군
46	전라남도	46730	구례군
46	전라남도	46770	고흥군
46	전라남도	46780	보성군
46	전라남도	46790	화순군
46	전라남도	46800	장흥군
46	전라남도	46810	강진군
46	전라남도	46820	해남군
46	전라남도	46830	영암군
46	전라남도	46840	무안군
46	전라남도	46860	함평군
46	전라남도	46870	영광군
46	전라남도	46880	장성군
46	전라남도	46890	완도군
46	전라남도	46900	진도군
46	전라남도	46910	신안군
47	경상북도	47111	포항시 남구
47	경상북도	47113	포항시 북구
47	경상북도	47130	경주시
47	경상북도	47150	김천시
47	경상북도	47170	안동시
47	경상북도	47190	구미시
47	경상북도	47210	영주시
47	경상북도	47230	영천시
47	경상북도	47250	상주시
47	경상북도	47280	문경시
47	경상북도	47290	경산시
47	경상북도	47720	군위군
47	경상북도	47730	의성군
47	경상북도	47750	청송군
47	경상북도	47760	영양군
47	경상북도	47770	영덕군
47	경상북도	47820	청도군
47	경상북도	47830	고령군
47	경상북도	47840	성주군
47	경상북도	47850	칠곡군
47	경상북도	47900	예천군
47	경상북도	47920	봉화군
47	경상북도	47930	울진군
47	경상북도	47940	울릉군
48	경상남도	48121	창원시 의창구
48	경상남도	48123	창원시 성산구
48	경상남도	48125	창원시 마산합포구
48	경상남도	48127	창원시 마산회원구
48	경상남도	48129	창원시 진해구
48	경상남도	48170	진주시
48	경상남도	48220	통영시
48	경상남도	48240	사천시
48	경상남도	48250	김해시
48	경상남도	48270	밀양시
48	경상남도	48310	거제시
48	경상남도	48330	양산시
48	경상남도	48720	의령군
48	경상남도	48730	함안군
48	경상남도	48740	창녕군
48	경상남도	48820	고성군
48	경상남도	48840	남해군
48	경상남도	48850	하동군
48	경상남도	48860	산청군
48	경상남도	48870	함양군
48	경상남도	48880	거창군
48	경상남도	48890	합천군
50	제주특별자치도	50110	제주시
50	제주특별자치도	50130	서귀포시