국가통계주요지표 Open API 지표정보조회서비스 활용가이드 통계청
문서정보 프로젝트단계활동작업산출물파일명 적용적용가이드작성활용가이드활용가이드 _ 지표정보조회서비스v2.2.doc 개정이력 버전 변경일 변경사유 변경내용 작성자 승인 1.0 2012-11-11 최초작성 최초작성 김현택이선기 2.0 2013-04-12 전면개정 전면개정 오장훈 오장훈 2.1 2013-04-19 추가내용반영오퍼레이션및요청항목추가 오장훈 오장훈 2.2 2013-11-26 추가내용반영서비스목록추가 / 삭제 김태일 김태일 1/52
목차 1. 서비스사용... 3 1.1. 서비스 Key 발급및활용... 3 1.2. API실데이터확인... 8 2. 서비스목록... 9 3. 서비스명세... 10 3.1. 지표정보조회서비스... 10 3.2. 지표명별설명자료조회서비스... 32 3.3. 지표고유번호별설명자료조회서비스... 39 3.4. 목록별지표조회서비스... 46 2/52
1. 서비스사용 1.1. 서비스 Key 발급및활용 가. 서비스 Key 발급 ( 인증신청및발급 ) (1) 공유자원포털 (http://data.go.kr) 활용자 활용신청하고자하는 API 를검색하여우측의활용신청버튼을클릭 활용신청하고자하는내역을입력하고, 활용할 API 를선택하여신청버튼을클릭 3/52
신청이완료되면신청목록이조회되고승인이완료된건을클릭하면인증키를확인할수있다 (2) 제공기관활용자 통계청활용신청페이지 (http://kosis.kr/pubc) 접속후아이디 / 비밀번호, 인증서를사용하여로그 인한다. 4/52
사용하고자하는공유자원 API 목록을조회한다. 선택한 API 에대한개발계정활용신청정보를입력하여개발계정을신청한다. 5/52
API 에대한개발계정신청내역을조회한다. 개발계정신청이승인되었을경우인증키를발급받을수있으며인증키가없을경우인증키발급버튼 이나타나며, 인증키가발급되어있을경우에는인증키재발급버튼이보인다. 버튼을클릭하게되면인 증키가발급된다. 6/52
나. 서비스인증키활용 (1) REST 방식의인증키활용 http://kosis.kr/kosisapi/service/indicatorservice/indlistsearchrequest?stat_jipyo_nm=%ea%b 0%95%EC%88%98%EB%9F%89&ServiceKey= 인증키 단, 발급받은인증키를 URL(UTF-8) encoding 한후사용 (2) SOAP 방식의인증키활용요청메시지 <?xml version="1.0" encoding="utf-8"?> <soapenv:envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:head="http://apache.org/headers" xmlns:soap="http://soap.open.pp.acrc/"> <soapenv:header> <head:commsgheader> <ServiceKey> 인증키 </ServiceKey> </head:commsgheader> </soapenv:header> <soapenv:body> <soap:getopenproposallist> <OpenPropListRequest> <nowpageno>1</nowpageno> <pagemg>2</pagemg> < region>5%ec%9b%9420101101</ region> <regto>20101130</regto> </OpenPropListRequest> </soap:getopenproposallist> </soapenv:body> </soapenv:envelope> 7/52
1.2. API 실데이터확인 개발자 LAB->API 실데이터확인메뉴를클릭하면목록화면이제공된다. 검색어를입력하고조회하면해당 API 목록이제공된다. 목록화면에서보기버튼을클릭하면 API 를통해제공되는실데이터를확인할수있다 8/52
2. 서비스목록 순번 서비스 ID 서비스명 ( 영문 ) 서비스명 ( 국문 ) 1 SC-SD-NS-IQ-001 IndicatorService 지표정보조회서비스 2 SC-SD-NS-ID-001 IndExplanationService 지표명별설명자료조회서비스 3 SC-SD-NS-IT-001 PkNumberService 고유번호별설명자료조회서비스 4 SC-SD-NS-IV-001 IndicatorListService 목록별지표조회서비스 볼드체 : 현기술물서에해당하는서비스 9/52
3. 서비스명세 3.1. 지표정보조회서비스 가. 서비스개요 서비스정보 서비스 ID 서비스명 ( 국문 ) 서비스명 ( 영문 ) SC-SD-NS-IQ-001 지표정보조회서비스 IndicatorService 지표목록을지표명, 고유번호, 수록주기로조회하거나, 지표 서비스설명 상세정보를조회하는서비스 서비스제공 기관명 통계청 담당자명 김태일주무관 자정보 담당자연락처 042-481-2388 담당자 e-mail Kim0215@korea.kr 서비스인증 / 권한 [ O ] 서비스 Key [ ] 인증서 (GPKI) [ O ] 서비스 Key [ ] Basic (ID/PW) [ ] 없음 [ ] 인증서 (GPKI) [ ] Basic (ID/PW) 서비스보안 [ ] 없음메시지레벨암호화 [ ] 전자서명 [ ] 암호화 [ ] 없음 [ ] 전자서명 [ ] 암호화 [ ] 없음 전송레벨암호화 [ ] SSL [ ] 없음 [ ] SOAP 1.2 (RPC-Encoded, Document Literal, Document Literal Wrapped) 적용기술수인터페이스표준 [ O ] REST (GET, POST, PUT, DELETE) 준 [ ] RSS 1.0 [ ] RSS 2.0 [ ] Atom 1.0 [ ] 기타 교환데이터표준 [ O ] XML [ ] JSON [ ] MIME [ ] MTOM 서비스 URL 개발환경 http:// 개발서버 /kosisapi/service/ IndicatorService 운영환경 http:// 운영서버 /kosisapi/service/ IndicatorService 서비스 WADL 개발환경 http:// 개발서버 /kosisapi/service/ IndicatorService?_wadl 운영환경 http:// 운영서버 /kosisapi/service/ IndicatorService?_wadl 서비스버전 서비스배포 유효일자 정보 서비스이력 최초배포 메시지교환유형 [ O ] Request-Response [ ] Publish-Subscribe [ ] Fire-and-Forgot [ ] Notification 메시지로깅수준 성공 [O] Header [ ] Body 실패 [O] Header [O} Body 10/52
사용제약사항 ( 비고 ) 나. 오퍼레이션목록 일련서비스명 ( 국문 ) 오퍼레이션명 ( 영문 ) 오퍼레이션명 ( 국문 ) 메시지명 ( 영문 ) 번호 1 getindlistsearch 지표명별목록조회 IndListSearchRequest 지표명별지표상세 IndDetailSearchRequest 2 getinddetailsearch 조회지표고유번호별목 IndIdListSearchRequest 3 지표정보조회 getindidlistsearch 록조회서비스지표고유번호별지 IndIdDetailSearchRequest 4 getindiddetailsearch 표상세조회지표수록주기별목 PrListSearchRequest 5 getprlistsearch 록조회 (1) 지표명별목록조회오퍼레이션명세 오퍼레이션번호 1 오퍼레이션명 ( 국문 ) 지표명별목록조회 오퍼레이션유형조회 ( 목록 ) 오퍼레이션명 ( 영문 ) getindlistsearch 오퍼이션정 보 오퍼레이션설명 Call Back URL 지표명으로해당지표목록을조회하는기능 N/A 최대메시지사이즈 [ 800bytes] 평균응답시간 1 초당최대트랜잭션 [ 30tps] 호출메시지정보응답메시지정보 메시지명 ( 영문 ) IndListSearchRequest 메시지타입 변수형 메시지설명 지표명을검색조건으로입력한다. 선행오퍼레이션 메시지명 ( 영문 ) IndListSearchResponse 메시지타입 리스트형 메시지설명 호출메시지의검색조건에따라지표목록을제공한다. HTTP Method [ O ] REST (GET, POST, PUT, DELETE) 1 요청메시지명세메시지명 ( 영문 ) http://kosis.kr/kosisapi/service/indicatorservice/indlistsearchrequest 항목명 ( 영문 ) 항목명 ( 국문 ) 유형샘플데이터항목설명 11/52
STAT_JIPYO_NM 지표명필수 강수량 (%EA%B0%95%E C%88%98%EB%9F%89) 조회할지표명 (URL(UTF-8) encoding) 입력 지표명 : 코드표 ([ 링크 ]) 참조 2 응답메시지명세 메시지명 ( 영문 ) IndListSearchResponse 항목명 ( 영문 ) 항목명 ( 국문 ) 샘플데이터 항목설명 statjipyoid 지표ID 20 지표ID statjipyonm 지표명 강수량 지표명 unit 단위 mm 단위 areatypename 지역구분명 시도 지역구분명 prdsename 수록주기명 월 수록주기명 strtprdde 수록시작시점 200801 수록시작시점 endprdde 수록종료시점 201212 수록종료시점 rn 수록시점개수 59 수록시점개수 3 요청 / 응답메시지예제 SOAP( 요청메세지 ) REST(URI) http://kosis.kr/kosisapi/service/indicatorservic I/IndListSearchRequest?STAT_JIPYO_NM=%EA%B0%95%E E%88%98%EB%9F%89&serviceKey= 서비스인증키 (URL(UTF-8) encoding) 응답메시지 <?xml version="1.0" encoding="utf-8" standalone="yes"?> - <response> - <header> <resultcode>0000</resultcode> <resultmsg>ok</resultmsg> </header> - <body> - <items> <areatypename> 시도 </areatypename> <endprdde>201212</endprdde> 12/52
<prdde>2012 년 12 월 </prdde> <prdsename> 월 </prdsename> <rn>59</rn> <statjipyoid>20</statjipyoid> <statjipyonm> 강수량 </statjipyonm> <strtprdde>200801</strtprdde> <unit>mm</unit> <areatypename> 북한 </areatypename> <endprdde>2012</endprdde> <prdde>2012 년 </prdde> <prdsename> 부정기 </prdsename> <rn>31</rn> <statjipyoid>1338</statjipyoid> <statjipyonm> 연간강수량 </statjipyonm> <strtprdde>1965</strtprdde> <unit>mm</unit> </items> </body> </response> (2) 지표명별지표상세조회오퍼레이션명세 오퍼레이션번호 2 오퍼레이션명 ( 국문 ) 지표명별지표상세 조회 오퍼레이션 정보 오퍼레이션유형 조회 ( 목록 ) 오퍼레이션명 ( 영문 ) getinddetailsearch 오퍼레이션설명 지표명으로해당지표를상세조회하는기능 Call Back URL N/A 최대메시지사이즈 [ 800bytes] 평균응답시간 [ 0.5ms] 초당최대트랜잭션 [ 30tps] 호출 메시지정보 메시지명 ( 영문 ) IndDetailSearchRequest 메시지타입 변수형 메시지설명 지표명을검색조건으로입력한다. 선행오퍼레이션 13/52
응답메시지 정보 메시지명 ( 영문 ) IndDetailSearchResponse 메시지타입 리스트형 메시지설명 호출메시지의검색조건에따라지표상세정보를제공한다. HTTP Method [ O ] REST (GET, POST, PUT, DELETE) 1 요청메시지명세메시지명 ( 영문 ) http://kosis.kr/kosisapi/service/indicatorservice/inddetailsearchrequest 항목명 ( 영문 ) 항목명 ( 국문 ) 유형샘플데이터항목설명조회할지표명 (URL(UTF-8) 주민등록인구 encoding ) 입력 STAT_JIPYO_NM 지표명필수 (EC%A3%BC%EB%AF%BC%EB%93%B1% 지표명 : 코드표 ([ 링크 ]) EB%A1%9D%EC%9D%B8%EA%B5%AC) 참조조회기준이되는시점 NULL, 0 : 수록종료시점 1 : 수록종료시점으로부터조회기준시 1번째시점 RN 선택 0 점 2 : 수록종료시점으로부터 2번째시점 (n : 수록종료시점으로부터 n번째시점 ) 조회기준시점으로부터조회할시점의개수 NULL, 0 : 전체시점조회조회시점개 SRV_RN 선택 1 1 : 1개시점조회수 2 : 2개시점조회 3 : 3개시점조회 (n : n개시점조회 ) 기간조회의시작시점과종료시점을설정한다. * 두항목은조회시작시 STRT_PRD_DE 선택반드시함께사용하여야한다. 점 STRT_PRD_DE 와 END_PRD_DE 의설정값예 수록주기별로자리수형태를달리한다. END_PRD_DE 조회종료시 점 선택 2000년 : 2000 2000년1월 : 200001 2000 년 1 월 1 일 : 20000101 2000 년 4/4 분기 : 200004 14/52
2000 년 2/2 반기 : 200002 2 응답메시지명세 메시지명 ( 영문 ) IndDetailSearchResponse 항목명 ( 영문 ) 항목명 ( 국문 ) 샘플데이터 항목설명 statjipyoid 지표ID 244 지표ID statjipyonm 지표명 주민등록인구 지표명 prdse 수록주기 Y 수록주기 prdde 시점 2012 시점 itmnm 항목 전국 항목 val 통계수치 50,948,272 통계수치 3 요청 / 응답메시지예제 SOAP( 요청메세지 ) REST(URI) http://kosis.kr/kosisapi/service/indicatorservic e/inddetailsearchrequest?stat_jipyo_nm=%ec%a3%bc %EB%AF%BC%EB%93%B1%EB%A1%9D%EC%9D%B8%EA%B5%AC&RN =0&SRV_RN=1& 서비스인증키 (URL(UTF-8) encoding) 응답메시지 <?xml version="1.0" encoding="utf-8" standalone="yes"?> - <response> - <header> <resultcode>0000</resultcode> <resultmsg>ok</resultmsg> </header> - <body> - <items> <itmnm> 전국 </itmnm> <prdde>2012</prdde> <statjipyoid>244</statjipyoid> <statjipyonm> 주민등록인구 </statjipyonm> <val>50,948,272</val> 15/52
<itmnm> 서울 </itmnm> <prdde>2012</prdde> <statjipyoid>245</statjipyoid> <statjipyonm> 주민등록인구 </statjipyonm> <val>10,195,318</val> <itmnm> 부산 </itmnm> <prdde>2012</prdde> <statjipyoid>245</statjipyoid> <statjipyonm> 주민등록인구 </statjipyonm> <val>3,538,484</val> <itmnm> 대구 </itmnm> <prdde>2012</prdde> <statjipyoid>245</statjipyoid> <statjipyonm> 주민등록인구 </statjipyonm> <val>2,505,644</val> <itmnm> 인천 </itmnm> <prdde>2012</prdde> <statjipyoid>245</statjipyoid> <statjipyonm> 주민등록인구 </statjipyonm> <val>2,843,981</val> <itmnm> 광주 </itmnm> <prdde>2012</prdde> 16/52
<statjipyoid>245</statjipyoid> <statjipyonm> 주민등록인구 </statjipyonm> <val>1,469,216</val> <itmnm> 대전 </itmnm> <prdde>2012</prdde> <statjipyoid>245</statjipyoid> <statjipyonm> 주민등록인구 </statjipyonm> <val>1,524,583</val> <itmnm> 울산 </itmnm> <prdde>2012</prdde> <statjipyoid>245</statjipyoid> <statjipyonm> 주민등록인구 </statjipyonm> <val>1,147,256</val> <itmnm> 경기 </itmnm> <prdde>2012</prdde> <statjipyoid>245</statjipyoid> <statjipyonm> 주민등록인구 </statjipyonm> <val>12,093,299</val> <itmnm> 강원 </itmnm> <prdde>2012</prdde> <statjipyoid>245</statjipyoid> <statjipyonm> 주민등록인구 </statjipyonm> <val>1,538,630</val> 17/52
<itmnm> 충북 </itmnm> <prdde>2012</prdde> <statjipyoid>245</statjipyoid> <statjipyonm> 주민등록인구 </statjipyonm> <val>1,565,628</val> <itmnm> 충남 </itmnm> <prdde>2012</prdde> <statjipyoid>245</statjipyoid> <statjipyonm> 주민등록인구 </statjipyonm> <val>2,028,777</val> <itmnm> 전북 </itmnm> <prdde>2012</prdde> <statjipyoid>245</statjipyoid> <statjipyonm> 주민등록인구 </statjipyonm> <val>1,873,341</val> <itmnm> 전남 </itmnm> <prdde>2012</prdde> <statjipyoid>245</statjipyoid> <statjipyonm> 주민등록인구 </statjipyonm> <val>1,909,618</val> <itmnm> 경북 </itmnm> <prdde>2012</prdde> 18/52
<statjipyoid>245</statjipyoid> <statjipyonm> 주민등록인구 </statjipyonm> <val>2,698,353</val> <itmnm> 경남 </itmnm> <prdde>2012</prdde> <statjipyoid>245</statjipyoid> <statjipyonm> 주민등록인구 </statjipyonm> <val>3,319,314</val> <itmnm> 제주 </itmnm> <prdde>2012</prdde> <statjipyoid>245</statjipyoid> <statjipyonm> 주민등록인구 </statjipyonm> <val>583,713</val> </items> </body> </response> (3) 고유번호별목록조회오퍼레이션명세 오퍼레이션번호 3 오퍼레이션명 ( 국문 ) 고유번호별목록조회 오퍼레이션유형조회 ( 목록 ) 오퍼레이션명 ( 영문 ) getindidlistsearch 오퍼레이션 정보 오퍼레이션설명 Call Back URL 고유번호로해당지표목록을조회하는기능 N/A 최대메시지사이즈 [ 800bytes] 평균응답시간 [ 0.5ms] 초당최대트랜잭션 [ 30tps] 호출 메시지정보 메시지명 ( 영문 ) IndIdListSearchRequest 메시지타입 변수형 메시지설명 지표ID를검색조건으로입력한다. 선행오퍼레이션 19/52
응답메시지 정보 메시지명 ( 영문 ) IndIdListSearchResponse 메시지타입 리스트형 메시지설명 호출메시지의검색조건에따라지표목록을제공한다. HTTP Method [ O ] REST (GET, POST, PUT, DELETE) 1 요청메시지명세 메시지명 ( 영문 ) http://kosis.kr/kosisapi/service/indicatorservice/indidlistsearchrequest 항목명 ( 영문 ) 항목명 ( 국문 ) 유형샘플데이터항목설명 STAT_JIPYO_ID 지표 ID 필수 50 지표 ID 지표 ID : 4. 코드표 ([ 링크 ]) 참조 2 응답메시지명세 메시지명 ( 영문 ) IndIdListSearchResponse 항목명 ( 영문 ) 항목명 ( 국문 ) 샘플데이터 항목설명 statjipyoid 지표ID 50 지표ID statjipyonm 지표명 교통사고사망자수 지표명 unit 단위 명 단위 areatypename 지역구분명 시도 지역구분명 prdsename 수록주기명 월 수록주기명 strtprdde 수록시작시점 200501 수록시작시점 endprdde 수록종료시점 201112 수록종료시점 rn 수록시점개수 83 수록시점개수 3 요청 / 응답메시지예제 SOAP( 요청메세지 ) REST(URI) http://kosis.kr/kosisapi/service/indicatorservic e/indidlistsearchrequest?stat_jipyo_id=50&servic ekey= 서비스인증키 (URL(UTF-8) encoding) 응답메시지 <?xml version="1.0" encoding="utf-8" standalone="yes"?> - <response> - <header> <resultcode>0000</resultcode> 20/52
<resultmsg>ok</resultmsg> </header> - <body> - <items> <areatypename> 시도 </areatypename> <endprdde>201112</endprdde> <prdde>2011년12월 </prdde> <prdsename> 월 </prdsename> <rn>83</rn> <statjipyoid>50</statjipyoid> <statjipyonm> 교통사고사망자수 </statjipyonm> <strtprdde>200501</strtprdde> <unit> 명 </unit> </items> </body> </response> (4) 고유번호별지표상세조회오퍼레이션명세 오퍼레이션번호 4 오퍼레이션명 ( 국문 ) 고유번호별지표상세 조회 오퍼레이션 정보 오퍼레이션유형 조회 ( 목록 ) 오퍼레이션명 ( 영문 ) getindiddetailsearch 오퍼레이션설명 고유번호로해당지표를상세조회하는기능 Call Back URL N/A 최대메시지사이즈 [ 800bytes] 평균응답시간 [ 0.5ms] 초당최대트랜잭션 [ 30tps] 호출메시지정보응답메시지정보 메시지명 ( 영문 ) IndIdDetailSearchRequest 메시지타입 변수형 메시지설명 지표ID를검색조건으로입력한다. 선행오퍼레이션 메시지명 ( 영문 ) IndIdDetailSearchResponse 메시지타입 리스트형 메시지설명 호출메시지의검색조건에따라지표상세정보를제공한다. HTTP Method [ O ] REST (GET, POST, PUT, DELETE) 21/52
1 요청메시지명세 메시지명 ( 영문 ) http://kosis.kr/kosisapi/service/indicatorservice/prdetailsearchrequest 항목명 ( 영문 ) 항목명 ( 국문 ) 유형 샘플데이터 항목설명 STAT_JIPYO_ID 지표ID 필수 295 지표ID 지표ID : 코드표 ([ 링크 ]) 참조 RN 조회기준시점 선택 0 조회기준이되는시점 NULL, 0 : 수록종료시점 1 : 수록종료시점으로부터 1 번째시점 2 : 수록종료시점으로부터 2 번째시점 (n : 수록종료시점으로부터 n번째시점 ) SRV_RN 조회시점개수 선택 2 조회기준시점으로부터조회할시점의개수 NULL, 0 : 전체시점조회 1 : 1개시점조회 2 : 2개시점조회 3 : 3개시점조회 (n : n개시점조회 ) STRT_PRD_DE 조회시작시점 선택 기간조회의시작시점과종료시점을설정한다. * 두항목은반드시함께사용하여야한다. END_PRD_DE 조회종료시점선택 STRT_PRD_DE와 END_PRD_DE의설정값예수록주기별로자리수형태를달리한다. 2000년 : 2000 2000년1월 : 200001 2000년1월1일 : 20000101 2000년4/4분기 : 200004 2000년2/2반기 : 200002 2 응답메시지명세 메시지명 ( 영문 ) IndIdDetailSearchResponse 항목명 ( 영문 ) 항목명 ( 국문 ) 샘플데이터 항목설명 statjipyoid 지표ID 295 지표ID 22/52
statjipyonm 지표명 인구 지표명 prdse 수록주기 Y 수록주기 prdde 시점 2013 시점 itmnm 항목 한국 항목 val 통계수치 50,220 통계수치 3 요청 / 응답메시지예제 SOAP( 요청메세지 ) REST(URI) http://kosis.kr/kosisapi/service/indicatorservic e/indiddetailsearchrequest?stat_jipyo_id=295&rn= 0&SRV_RN=2&serviceKey= 서비스인증키 (URL(UTF-8) encoding) 응답메시지 <?xml version="1.0" encoding="utf-8" standalone="yes"?> - <response> - <header> <resultcode>0000</resultcode> <resultmsg>ok</resultmsg> </header> - <body> - <items> <itmnm> 한국 </itmnm> <prdde>2013</prdde> <statjipyoid>295</statjipyoid> <statjipyonm> 인구 </statjipyonm> <val>50,220</val> <itmnm> 중국 </itmnm> <prdde>2013</prdde> <statjipyoid>295</statjipyoid> <statjipyonm> 인구 </statjipyonm> <val>1,359,368</val> 23/52
<itmnm> 인도 </itmnm> <prdde>2013</prdde> <statjipyoid>295</statjipyoid> <statjipyonm> 인구 </statjipyonm> <val>1,275,138</val> <itmnm> 인도네시아 </itmnm> <prdde>2013</prdde> <statjipyoid>295</statjipyoid> <statjipyonm> 인구 </statjipyonm> <val>247,188</val> <itmnm> 일본 </itmnm> <prdde>2013</prdde> <statjipyoid>295</statjipyoid> <statjipyonm> 인구 </statjipyonm> <val>126,345</val> <itmnm> 사우디아라비아 </itmnm> <prdde>2013</prdde> <statjipyoid>295</statjipyoid> <statjipyonm> 인구 </statjipyonm> <val>29,319</val> <itmnm> 터키 </itmnm> <prdde>2013</prdde> 24/52
<statjipyoid>295</statjipyoid> <statjipyonm> 인구 </statjipyonm> <val>75,359</val> <itmnm> 캐나다 </itmnm> <prdde>2013</prdde> <statjipyoid>295</statjipyoid> <statjipyonm> 인구 </statjipyonm> <val>34,994</val> <itmnm> 멕시코 </itmnm> <prdde>2013</prdde> <statjipyoid>295</statjipyoid> <statjipyonm> 인구 </statjipyonm> <val>117,478</val> <itmnm> 미국 </itmnm> <prdde>2013</prdde> <statjipyoid>295</statjipyoid> <statjipyonm> 인구 </statjipyonm> <val>318,498</val> <itmnm> 아르헨티나 </itmnm> <prdde>2013</prdde> <statjipyoid>295</statjipyoid> <statjipyonm> 인구 </statjipyonm> <val>41,474</val> 25/52
<itmnm> 브라질 </itmnm> <prdde>2013</prdde> <statjipyoid>295</statjipyoid> <statjipyonm> 인구 </statjipyonm> <val>200,050</val> <itmnm> 프랑스 </itmnm> <prdde>2013</prdde> <statjipyoid>295</statjipyoid> <statjipyonm> 인구 </statjipyonm> <val>63,783</val> <itmnm> 독일 </itmnm> <prdde>2013</prdde> <statjipyoid>295</statjipyoid> <statjipyonm> 인구 </statjipyonm> <val>81,804</val> <itmnm> 이탈리아 </itmnm> <prdde>2013</prdde> <statjipyoid>295</statjipyoid> <statjipyonm> 인구 </statjipyonm> <val>61,087</val> <itmnm> 러시아 </itmnm> <prdde>2013</prdde> 26/52
<statjipyoid>295</statjipyoid> <statjipyonm> 인구 </statjipyonm> <val>142,558</val> <itmnm> 영국 </itmnm> <prdde>2013</prdde> <statjipyoid>295</statjipyoid> <statjipyonm> 인구 </statjipyonm> <val>63,177</val> <itmnm> 남아프리카공화국 </itmnm> <prdde>2013</prdde> <statjipyoid>295</statjipyoid> <statjipyonm> 인구 </statjipyonm> <val>50,981</val> <itmnm> 오스트레일리아 </itmnm> <prdde>2013</prdde> <statjipyoid>295</statjipyoid> <statjipyonm> 인구 </statjipyonm> <val>23,214</val> </items> </body> </response> (5) 수록주기별목록조회오퍼레이션명세 오퍼레이션 정보 오퍼레이션번호 5 오퍼레이션명 ( 국문 ) 지표수록주기별목록 조회 27/52
오퍼레이션유형조회 ( 목록 ) 오퍼레이션명 ( 영문 ) getprlistsearch 오퍼레이션설명 Call Back URL 수록주기로해당지표목록을조회하는기능 N/A 최대메시지사이즈 [ 800bytes] 평균응답시간 [ 0.5ms] 초당최대트랜잭션 [ 30tps] 호출메시지정보응답메시지정보 메시지명 ( 영문 ) PrListSearchRequest 메시지타입 변수형 메시지설명 수록주기를검색조건으로입력한다. 선행오퍼레이션 메시지명 ( 영문 ) PrListSearchResponse 메시지타입 리스트형 메시지설명 호출메시지의검색조건에따라지표목록을제공한다. HTTP Method [ O ] REST (GET, POST, PUT, DELETE) 1 요청메시지명세 메시지명 ( 영문 ) http://kosis.kr/kosisapi/service/indicatorservice/prlistsearchrequest 항목명 ( 영문 ) 항목명 ( 국문 ) 유형 샘플데이터 항목설명 PRD_SE 수록주기 필수 Y D : 일 T : 순기 M : 월 B : 격월 Q : 분기 H : 반기 Y : 년 F : 부정기 2 응답메시지명세 메시지명 ( 영문 ) PrListSearchResponse 항목명 ( 영문 ) 항목명 ( 국문 ) 샘플데이터 항목설명 statjipyoid 지표ID 244 지표ID statjipyonm 지표명 주민등록인구 지표명 unit 단위 명 단위 areatypename 지역구분명 전국 지역구분명 prdsename 수록주기명 년 수록주기명 strtprdde 수록시작시점 2000 수록시작시점 28/52
endprdde 수록종료시점 2012 수록종료시점 rn 수록시점개수 12 수록시점개수 3 요청 / 응답메시지예제 SOAP( 요청메세지 ) REST(URI) http://kosis.kr/kosisapi/service/indicatorservic e/prlistsearchrequest?prd_se=y&servicekey= 서비스인증키 (URL(UTF-8) encoding) 응답메시지 <?xml version="1.0" encoding="utf-8" standalone="yes"?> - <response> - <header> <resultcode>0000</resultcode> <resultmsg>ok</resultmsg> </header> - <body> - <items> <areatypename> 전국 </areatypename> <endprdde>2012</endprdde> <prdde>2012년 </prdde> <prdsename> 년 </prdsename> <rn>12</rn> <statjipyoid>244</statjipyoid> <statjipyonm> 주민등록인구 </statjipyonm> <strtprdde>2000</strtprdde> <unit> 명 </unit> <areatypename> 시도 </areatypename> <endprdde>2012</endprdde> <prdde>2012년 </prdde> <prdsename> 년 </prdsename> <rn>12</rn> <statjipyoid>245</statjipyoid> 29/52
<statjipyonm> 주민등록인구 </statjipyonm> <strtprdde>2000</strtprdde> <unit> 명 </unit> <areatypename> 전국 </areatypename> <endprdde>2013</endprdde> <prdde>2013년 </prdde> <prdsename> 년 </prdsename> <rn>53</rn> <statjipyoid>908</statjipyoid> <statjipyonm> 추계인구 </statjipyonm> <strtprdde>1960</strtprdde> <unit> 명 </unit> <areatypename> 시도 </areatypename> <endprdde>2013</endprdde> <prdde>2013년 </prdde> <prdsename> 년 </prdsename> <rn>43</rn> <statjipyoid>273</statjipyoid> <statjipyonm> 추계인구 </statjipyonm> <strtprdde>1970</strtprdde> <unit> 명 </unit> <areatypename> 시도 </areatypename> <endprdde>2011</endprdde> <prdde>2011년 </prdde> <prdsename> 년 </prdsename> <rn>8</rn> <statjipyoid>200</statjipyoid> <statjipyonm> 시도별인구증가율 ( 주민등록인구기준 )</statjipyonm> <strtprdde>2003</strtprdde> <unit>%</unit> 30/52
<areatypename> 시도 </areatypename> <endprdde>2012</endprdde> <prdde>2012년 </prdde> <prdsename> 년 </prdsename> <rn>42</rn> <statjipyoid>145</statjipyoid> <statjipyonm> 순이동 ( 전입-전출 )</statjipyonm> <strtprdde>1970</strtprdde> <unit> 명 </unit> <areatypename> 전국 </areatypename> <endprdde>2011</endprdde> <prdde>2011년 </prdde> <prdsename> 년 </prdsename> <rn>19</rn> <statjipyoid>98</statjipyoid> <statjipyonm> 외국인수 ( 등록외국인 )</statjipyonm> <strtprdde>1992</strtprdde> <unit> 명 </unit> <areatypename> 시도 </areatypename> <endprdde>2011</endprdde> <prdde>2011년 </prdde> <prdsename> 년 </prdsename> <rn>19</rn> <statjipyoid>97</statjipyoid> <statjipyonm> 외국인수 ( 등록외국인 )</statjipyonm> <strtprdde>1992</strtprdde> <unit> 명 </unit> ## 이하생략 ## 31/52
3.2. 지표명별설명자료조회서비스 가. 서비스개요 서비스정보 서비스 ID 서비스명 ( 국문 ) 서비스명 ( 영문 ) 서비스설명 SC-SD-NS-ID-001 지표명별설명자료조회서비스 IndExplanationService 개념, 산정방법별, 출처등을지표명으로조회하는서비스 서비스제공 기관명 통계청 담당자명 김태일주무관 자정보 담당자연락처 042-481-2388 담당자 e-mail Kim0215@korea.kr 서비스인증 / 권한 [ O ] 서비스 Key [ ] 인증서 (GPKI) [ O ] 서비스 Key [ ] Basic (ID/PW) [ ] 없음 [ ] 인증서 (GPKI) [ ] Basic (ID/PW) 서비스보안 [ ] 없음메시지레벨암호화 [ ] 전자서명 [ ] 암호화 [ ] 없음 [ ] 전자서명 [ ] 암호화 [ ] 없음 전송레벨암호화 [ ] SSL [ ] 없음 [ ] SOAP 1.2 (RPC-Encoded, Document Literal, Document Literal Wrapped) 적용기술수인터페이스표준 [ O ] REST (GET, POST, PUT, DELETE) 준 [ ] RSS 1.0 [ ] RSS 2.0 [ ] Atom 1.0 [ ] 기타 교환데이터표준 [ O ] XML [ ] JSON [ ] MIME [ ] MTOM 서비스 URL 개발환경 http:// 개발서버 /kosisapi/service/ IndExplanationService 운영환경 http:// 운영서버 /kosisapi/service/ IndExplanationService http:// 개발서버 /kosisapi/service/indexplanationservice?_ 개발환경 wadl 서비스 WADL http:// 운영서버 /kosisapi/service/indexplanationservice?_ 운영환경 wadl 서비스버전 서비스배포 유효일자 정보 서비스이력 최초배포 메시지교환유형 [ O ] Request-Response [ ] Publish-Subscribe [ ] Fire-and-Forgot [ ] Notification 메시지로깅수준 성공 [O] Header [ ] Body 실패 [O] Header [O} Body 사용제약사항 ( 비고 ) 32/52
나. 오퍼레이션목록 일련번호 서비스명 ( 국문 ) 오퍼레이션명 ( 영문 ) 1 getindnotionsearch 2 지표명별설명자료조회 getindoriginsearch 3 getindallexpsearch 오퍼레이션명 ( 국문 ) 지표명별개념조회지표명별산정방법및출처조회지표명별전체설명자료조회 메시지명 ( 영문 ) IndNotionSearchRequest IndOriginSearchRequest IndAllExpSearchRequest (1) 지표명별개념조회오퍼레이션명세 오퍼레이션번호 1 오퍼레이션명 ( 국문 ) 지표명별개념조회 오퍼레이션유형조회 ( 목록 ) 오퍼레이션명 ( 영문 ) getindnotionsearch 오퍼레이션 정보 오퍼레이션설명 Call Back URL 지표명으로해당지표의개념을조회하는기능 N/A 최대메시지사이즈 [ 2280bytes] 평균응답시간 [ 0.5ms] 초당최대트랜잭션 [ 30tps] 호출메시지정보응답메시지정보 메시지명 ( 영문 ) IndNotionSearchRequest 메시지타입 변수형 메시지설명 지표명을검색조건으로입력한다. 선행오퍼레이션 메시지명 ( 영문 ) IndNotionSearchResponse 메시지타입 리스트형 메시지설명 호출메시지의검색조건에따라개념정보를제공한다. HTTP Method [ O ] REST (GET, POST, PUT, DELETE) 1 요청메시지명세 메시지명 ( 영문 ) http://kosis.kr/kosisapi/service/indexplanationservice/indnotionsearchrequest 항목명 ( 영문 ) 항목명 ( 국문 ) 유형샘플데이터항목설명 STAT_JIPYO_NM 지표명필수 지방재정자립도 (EC%9E%AC%EC%A0%95 %EC%9E%90%EB%A6%BD%EB%8F%84) 조회할지표명 (URL(UTF-8) encoding ) 입력 지표명 : 코드표 ([ 링크 ]) 참조 33/52
2 응답메시지명세 메시지명 ( 영문 ) IndNotionSearchResponse 항목명 ( 영문 ) 항목명 ( 국문 ) 샘플데이터 항목설명 jipyoexplan 설명자료제목 재정자립도 설명자료제목 statexplan1 개념 재정수입의자체충당능력을나타내는세입분석지표로, 일반회계의세입중지방세와세외수입의비율로측정 개념 3 요청 / 응답메시지예제 SOAP( 요청메세지 ) REST(URI) http://kosis.kr/kosisapi/service/indexplanations ervice/indnotionsearchrequest?stat_jipyo_nm=%ec% 9E%AC%EC%A0%95%EC%9E%90%EB%A6%BD%EB%8F%84&servic ekey= 서비스인증키 (URL(UTF-8) encoding) 응답메시지 <?xml version="1.0" encoding="utf-8" standalone="yes"?> - <response> - <header> <resultcode>0000</resultcode> <resultmsg>ok</resultmsg> </header> - <body> - <items> <jipyoexplan> 재정자립도 </jipyoexplan> <statexplan1> 재정수입의자체충당능력을나타내는세입분석지표로, 일반회계의세입중지방세와세외수입의비율로측정 </statexplan1> <statjipyonm> 지방재정자립도 </statjipyonm> </items> </body> </response> (2) 지표명별산정방법및출처조회오퍼레이션명세 오퍼레이션오퍼레이션번호 2 오퍼레이션명 ( 국문 ) 지표명별산정방법및 34/52
정보 출처조회 오퍼레이션유형조회 ( 상세 ) 오퍼레이션명 ( 영문 ) getindoriginsearch 오퍼레이션설명 Call Back URL 지표명으로해당지표의산정방법및출처를조회하는기능 N/A 최대메시지사이즈 [ 2280bytes] 평균응답시간 [ 0.5ms] 초당최대트랜잭션 [ 30tps] 호출메시지정보응답메시지정보 메시지명 ( 영문 ) IndOriginSearchRequest 메시지타입 변수형 메시지설명 지표명을검색조건으로입력한다. 선행오퍼레이션 메시지명 ( 영문 ) IndOriginSearchResponse 메시지타입 리스트형 메시지설명 HTTP Method 호출메시지의검색조건에따라산정방법및출처정보를제공한다. [ O ] REST (GET, POST, PUT, DELETE) 1 요청메시지명세 메시지명 ( 영문 ) http://kosis.kr/kosisapi/service/indexplanationservice/indoriginsearchrequest 항목명 ( 영문 ) 항목명 ( 국문 ) 유형샘플데이터항목설명 STAT_JIPYO_NM 지표명필수 지방재정자립도 (EC%9E%AC%EC%A0%95 %EC%9E%90%EB%A6%BD%EB%8F%84) 조회할지표명 (URL(UTF-8) encoding ) 입력 지표명 : 코드표 ([ 링크 ]) 참조 2 응답메시지명세 메시지명 ( 영문 ) IndOriginSearchResponse 항목명 ( 영문 ) 항목명 ( 국문 ) 샘플데이터 항목설명 jipyoexplan 설명자료제목 재정자립도 설명자료제목 statexplan2 산정방법 재정자립도 = ( 지방세 + 세외수입 ) x 산정방법 100 / 자치단체예산규모 <br/>( 전국및시도별평균은순계예산규모로산출 ) statexplan3 출처 안전행정부, 지방자치단체통합재정개요 출처 35/52
3 요청 / 응답메시지예제 SOAP( 요청메세지 ) REST(URI) http://kosis.kr/kosisapi/service/indexplanations ervice/indoriginsearchrequest?stat_jipyo_nm=%ec% 9E%AC%EC%A0%95%EC%9E%90%EB%A6%BD%EB%8F%84&servic ekey= 서비스인증키 (URL(UTF-8) encoding) 응답메시지 <?xml version="1.0" encoding="utf-8" standalone="yes"?> - <response> - <header> <resultcode>0000</resultcode> <resultmsg>ok</resultmsg> </header> - <body> - <items> <jipyoexplan> 재정자립도 </jipyoexplan> <statexplan2> 재정자립도 = ( 지방세 + 세외수입 ) x 100 / 자치단체예산규모 <br/>( 전국및시도별평균은순계예산규모로산출 )</statexplan2> <statexplan3> 안전행정부, 지방자치단체통합재정개요 </statexplan3> <statjipyonm> 지방재정자립도 </statjipyonm> </items> </body> </response> (3) 지표명별전체설명자료조회오퍼레이션명세 오퍼레이션번호 3 오퍼레이션명 ( 국문 ) 지표명별전체설명자 료조회 오퍼레이션 정보 오퍼레이션유형 조회 ( 상세 ) 오퍼레이션명 ( 영문 ) getindallexpsearch 오퍼레이션설명 지표명으로전체설명자료를조회하는기능 Call Back URL N/A 최대메시지사이즈 [ 2280bytes] 평균응답시간 [ 0.5ms] 초당최대트랜잭션 [ 30tps] 호출메시지명 ( 영문 ) IndAllExpSearchRequest 36/52
메시지정보메시지타입변수형 메시지설명지표명을검색조건으로입력한다. 선행오퍼레이션 응답메시지 정보 메시지명 ( 영문 ) IndAllExpSearchResponse 메시지타입 리스트형 메시지설명 호출메시지의검색조건에따라전체설명자료정보를제공한다. HTTP Method [ O ] REST (GET, POST, PUT, DELETE) 1 요청메시지명세 메시지명 ( 영문 ) http://kosis.kr/kosisapi/service/indexplanationservice/indallexpsearchrequest 항목명 ( 영문 ) 항목명 ( 국문 ) 유형샘플데이터항목설명 STAT_JIPYO_NM 지표명필수 지방재정자립도 (EC%9E%AC%EC%A0%95 %EC%9E%90%EB%A6%BD%EB%8F%84) 조회할지표명 (URL(UTF-8) encoding ) 입력 지표명 : 코드표 ([ 링크 ]) 참조 2 응답메시지명세 메시지명 ( 영문 ) IndAllExpSearchResponse 항목명 ( 영문 ) 항목명 ( 국문 ) 샘플데이터 항목설명 jipyoexplan 설명자료제목 재정자립도 설명자료제목 statexplan1 개념 재정수입의자체충당능력을나타내 개념 는세입분석지표로, 일반회계의세입중지방세와세외수입의비율로측정 statexplan2 산정방법 재정자립도 = ( 지방세 + 세외수입 ) x 산정방법 100 / 자치단체예산규모 <br/>( 전국및시도별평균은순계예산규모로산출 ) statexplan3 출처 안전행정부, 지방자치단체통합재정개요 출처 3 요청 / 응답메시지예제 SOAP( 요청메세지 ) REST(URI) 37/52
http://kosis.kr/kosisapi/service/indexplanations ervice/indallexpsearchrequest?stat_jipyo_nm=%ec% 9E%AC%EC%A0%95%EC%9E%90%EB%A6%BD%EB%8F%84&servic ekey= 서비스인증키 (URL(UTF-8) encoding) 응답메시지 <?xml version="1.0" encoding="utf-8" standalone="yes"?> - <response> - <header> <resultcode>0000</resultcode> <resultmsg>ok</resultmsg> </header> - <body> - <items> <jipyoexplan> 재정자립도 </jipyoexplan> <statexplan1> 재정수입의자체충당능력을나타내는세입분석지표로, 일반회계의세입중지방세와세외수입의비율로측정 </statexplan1> <statexplan2> 재정자립도 = ( 지방세 + 세외수입 ) x 100 / 자치단체예산규모 <br/>( 전국및시도별평균은순계예산규모로산출 )</statexplan2> <statexplan3> 안전행정부, 지방자치단체통합재정개요 </statexplan3> <statjipyonm> 지방재정자립도 </statjipyonm> </items> </body> </response> 38/52
3.3. 지표고유번호별설명자료조회서비스 가. 서비스개요 서비스정보 서비스 ID 서비스명 ( 국문 ) 서비스명 ( 영문 ) 서비스설명 SC-SD-NS-IT-001 지표고유번호별설명자료조회 PkNumberService 개념, 산정방법별, 출처등을지표고유번호로조회하는서비스 서비스제공 기관명 통계청 담당자명 김태일주무관 자정보 담당자연락처 042-481-2388 담당자 e-mail Kim0215@korea.kr 서비스인증 / 권한 [ O ] 서비스 Key [ ] 인증서 (GPKI) [ O ] 서비스 Key [ ] Basic (ID/PW) [ ] 없음 [ ] 인증서 (GPKI) [ ] Basic (ID/PW) 서비스보안 [ ] 없음메시지레벨암호화 [ ] 전자서명 [ ] 암호화 [ ] 없음 [ ] 전자서명 [ ] 암호화 [ ] 없음 전송레벨암호화 [ ] SSL [ ] 없음 [ ] SOAP 1.2 (RPC-Encoded, Document Literal, Document Literal Wrapped) 적용기술수인터페이스표준 [ O ] REST (GET, POST, PUT, DELETE) 준 [ ] RSS 1.0 [ ] RSS 2.0 [ ] Atom 1.0 [ ] 기타 교환데이터표준 [ O ] XML [ ] JSON [ ] MIME [ ] MTOM 서비스 URL 개발환경 http:// 개발서버 /kosisapi/service/pknumberservice 운영환경 http:// 운영서버 /kosisapi/service/pknumberservice 서비스 WADL 개발환경 http:// 개발서버 /kosisapi/service/pknumberservice?_ wadl 운영환경 http:// 운영서버 /kosisapi/service/pknumberservice?_ wadl 서비스버전 서비스배포 유효일자 정보 서비스이력 최초배포 메시지교환유형 [ O ] Request-Response [ ] Publish-Subscribe [ ] Fire-and-Forgot [ ] Notification 메시지로깅수준 성공 [O] Header [ ] Body 실패 [O] Header [O} Body 사용제약사항 ( 비고 ) 39/52
나. 오퍼레이션목록 일련번호 서비스명 ( 국문 ) 오퍼레이션명 ( 영문 ) 오퍼레이션명 ( 국문 ) 메시지명 ( 영문 ) 지표고유번호별개 PkNotionSearchRequest 1 getpknotionsearch 념조회지표고유번호지표고유번호별산 PkOriginSearchRequest 2 별설명자료조 getpkoriginsearch 정방법및출처조회회지표고유번호별전 PkAllExpEarchRequest 3 getpkallexpearch 체설명자료조회 (1) 지표고유번호별개념조회오퍼레이션명세 오퍼레이션번호 1 오퍼레이션명 ( 국문 ) 지표고유번호별개념 조회 오퍼레이션 정보 오퍼레이션유형 조회 ( 목록 ) 오퍼레이션명 ( 영문 ) getpknotionsearch 오퍼레이션설명 지표고유번호로해당지표의개념을조회하는기능 Call Back URL N/A 최대메시지사이즈 [ 2280bytes] 평균응답시간 [ 0.5ms] 초당최대트랜잭션 [ 30tps] 호출메시지정보응답메시지정보 메시지명 ( 영문 ) PkNotionSearchRequest 메시지타입 변수형 메시지설명 지표ID를검색조건으로입력한다. 선행오퍼레이션 메시지명 ( 영문 ) PkNotionSearchResponse 메시지타입 리스트형 메시지설명 호출메시지의검색조건에따라개념정보를제공한다. HTTP Method [ O ] REST (GET, POST, PUT, DELETE) 1 요청메시지명세 메시지명 ( 영문 ) http://kosis.kr/kosisapi/service/pknumberservice/pknotionsearchrequest 항목명 ( 영문 ) 항목명 ( 국문 ) 유형 샘플데이터 항목설명 지표ID STAT_JIPYO_ID 지표ID 필수 586 지표ID : 4. 코드표 ([ 링크 ]) 참조 40/52
2 응답메시지명세 메시지명 ( 영문 ) PkNotionSearchResponse 항목명 ( 영문 ) 항목명 ( 국문 ) 샘플데이터 항목설명 jipyoexplan 설명자료제목 외환보유액 설명자료제목 statexplan1 개념 국제수지불균형을보전하거나외환시장안정을위해언제든지사용할수있는중앙은행또는정부의대외자산 개념 3 요청 / 응답메시지예제 SOAP( 요청메세지 ) REST(URI) http://kosis.kr/kosisapi/service/pknumberservice/ PkNotionSearchRequest?STAT_JIPYO_ID=50&servi cekey= 서비스인증키 (URL(UTF-8) encoding) 응답메시지 <response> - <header> <resultcode>0000</resultcode> <resultmsg>ok</resultmsg> </header> - <body> - <items> <jipyoexplan> 외환보유액 </jipyoexplan> <statexplan1> 국제수지불균형을보전하거나외환시장안정을위해언제든지사용할수있는중앙은행또는정부의대외자산 </statexplan1> </items> </body> </response> (2) 지표고유번호별산정방법및출처조회오퍼레이션명세 오퍼레이션 정보 지표고유번호별산정 오퍼레이션번호 2 오퍼레이션명 ( 국문 ) 방법및출처조회 오퍼레이션유형 조회 ( 상세 ) 오퍼레이션명 ( 영문 ) getpkoriginsearch 41/52
오퍼레이션설명 Call Back URL 지표고유번호로해당지표의산정방법및출처를조회하는서 비스 N/A 최대메시지사이즈 [ 2280bytes] 평균응답시간 [ 0.5ms] 초당최대트랜잭션 [ 30tps] 호출메시지정보응답메시지정보 메시지명 ( 영문 ) PkOriginSearchRequest 메시지타입 변수형 메시지설명 지표ID를검색조건으로입력한다. 선행오퍼레이션 메시지명 ( 영문 ) PkOriginSearchResponse 메시지타입 리스트형 메시지설명 HTTP Method 호출메시지의검색조건에따라산정방법및출처정보를제공한다. [ O ] REST (GET, POST, PUT, DELETE) 1 요청메시지명세 메시지명 ( 영문 ) http://kosis.kr/kosisapi/service/pknumberservice/pkoriginsearchrequest 항목명 ( 영문 ) 항목명 ( 국문 ) 유형 샘플데이터 항목설명 STAT_JIPYO_ID 지표ID 필수 286 지표ID 지표ID : 코드표 ([ 링 크 ]) 참조 2 응답메시지명세 메시지명 ( 영문 ) PkOriginSearchResponse 항목명 ( 영문 ) 항목명 ( 국문 ) 샘플데이터 항목설명 jipyoexplan 설명자료제목 외환보유액 설명자료제목 statexplan2 선정방법 IMF의외환보유액통계편제기준에 선정방법 따라매월말산출 statexplan3 출처정보 한국은행, 외환수급통계 출처정보 3 요청 / 응답메시지예제 SOAP( 요청메세지 ) REST(URI) http://kosis.kr/kosisapi/service/pknumberservice/ PkNotionSearchRequest?STAT_JIPYO_ID=50&servi cekey= 서비스인증키 (URL(UTF-8) encoding) 42/52
응답메시지 <?xml version="1.0" encoding="utf-8" standalone="yes"?> - <response> - <header> <resultcode>0000</resultcode> <resultmsg>ok</resultmsg> </header> - <body> - <items> <jipyoexplan> 외환보유액 </jipyoexplan> <statexplan2>imf의외환보유액통계편제기준에따라매월말산출 </statexplan2> <statexplan3> 한국은행, 외환수급통계 </statexplan3> </items> </body> </response> (3) 지표고유번호별전체설명자료조회오퍼레이션명세 오퍼레이션번호 3 오퍼레이션명 ( 국문 ) 지표고유번호별전체 설명자료조회 오퍼레이션 정보 오퍼레이션유형 조회 ( 상세 ) 오퍼레이션명 ( 영문 ) getpkallexpearch 오퍼레이션설명 지표고유번호로해당지표의전체설명자료를조회하는기능 Call Back URL N/A 최대메시지사이즈 [ 2280bytes] 평균응답시간 [ 0.5ms] 초당최대트랜잭션 [ 30tps] 호출메시지정보응답메시지정보 메시지명 ( 영문 ) PkAllExpEarchRequest 메시지타입 변수형 메시지설명 전체설명자료에서해당하는지표ID의설명자료를조회한다. 선행오퍼레이션 메시지명 ( 영문 ) PkAllExpEarchResponse 메시지타입 리스트형 메시지설명 호출메시지의검색조건에따라전체설명자료정보를제공한다. HTTP Method [ O ] REST (GET, POST, PUT, DELETE) 43/52
1 요청메시지명세 메시지명 ( 영문 ) http://kosis.kr/kosisapi/service/pknumberservice/pkallexpsearchrequest 항목명 ( 영문 ) 항목명 ( 국문 ) 유형 샘플데이터 항목설명 STAT_JIPYO_ID 지표ID 필수 286 지표ID 지표ID : 코드표 ([ 링크 ]) 참조 2 응답메시지명세 메시지명 ( 영문 ) PkAllExpEarchResponse 항목명 ( 영문 ) 항목명 ( 국문 ) 샘플데이터 항목설명 jipyoexplan 설명자료제목 외환보유액 설명자료제목 statexplan1 개념 국제수지불균형을보전하거나외환시 개념 장안정을위해언제든지사용할수있는중앙은행또는정부의대외자산 statexplan2 선정방법 IMF의외환보유액통계편제기준에 선정방법 따라매월말산출 statexplan3 출처정보 한국은행, 외환수급통계 출처정보 3 요청 / 응답메시지예제 SOAP( 요청메세지 ) REST(URI) http://kosis.kr/kosisapi/service/pknumberservice/ PkAllExpSearchRequest?STAT_JIPYO_ID=50&servi cekey= 서비스인증키 (URL(UTF-8) encoding) 응답메시지?xml version="1.0" encoding="utf-8" standalone="yes"?> <response> <header> <resultcode>0000</resultcode> <resultmsg>ok</resultmsg> </header> <body> <items> <item> <jipyoexplan> 외환보유액 </jipyoexplan> 44/52
<statexplan1> 국제수지불균형을보전하거나외환시장안정을위해언제든지사용할수있는중앙은행또는정부의대외자산 </statexplan1> <statexplan2>imf의외환보유액통계편제기준에따라매월말산출 </statexplan2> <statexplan3> 한국은행, 외환수급통계 </statexplan3> </items> </body> </response> 45/52
3.4. 목록별지표조회서비스 가. 서비스개요 서비스정보 서비스 ID 서비스명 ( 국문 ) 서비스명 ( 영문 ) 서비스설명 SC-SD-NS-IV-001 목록별지표조회서비스 IndicatorListService 지표리스트를목록ID로조회하는서비스 서비스제공 기관명 통계청 담당자명 김태일주무관 자정보 담당자연락처 042-481-2388 담당자 e-mail Kim0215@korea.kr 서비스인증 / 권한 [ O ] 서비스 Key [ ] 인증서 (GPKI) [ O ] 서비스 Key [ ] Basic (ID/PW) [ ] 없음 [ ] 인증서 (GPKI) [ ] Basic (ID/PW) 서비스보안 [ ] 없음메시지레벨암호화 [ ] 전자서명 [ ] 암호화 [ ] 없음 [ ] 전자서명 [ ] 암호화 [ ] 없음 전송레벨암호화 [ ] SSL [ ] 없음 [ ] SOAP 1.2 (RPC-Encoded, Document Literal, Document Literal Wrapped) 적용기술수인터페이스표준 [ O ] REST (GET, POST, PUT, DELETE) 준 [ ] RSS 1.0 [ ] RSS 2.0 [ ] Atom 1.0 [ ] 기타 교환데이터표준 [ O ] XML [ ] JSON [ ] MIME [ ] MTOM 서비스 URL 개발환경 http:// 개발서버 /kosisapi/service/ IndicatorListService 운영환경 http:// 운영서버 /kosisapi/service/ IndicatorListService http:// 개발서버 /kosisapi/service/ 개발환경 IndicatorListService?_wadl 서비스 WADL http:// 운영서버 /kosisapi/service/ 운영환경 IndicatorListService?_wadl 서비스버전 서비스배포 유효일자 정보 서비스이력 최초배포 메시지교환유형 [ O ] Request-Response [ ] Publish-Subscribe [ ] Fire-and-Forgot [ ] Notification 메시지로깅수준 성공 [O] Header [ ] Body 실패 [O] Header [O} Body 사용제약사항 ( 비고 ) 46/52
나. 오퍼레이션목록 일련 번호 1 서비스명 ( 국문 ) 목록별지표조회서비스 오퍼레이션명 ( 영문 ) 오퍼레이션명 ( 국문 ) 메시지명 ( 영문 ) getindicatorlistsearch 목록별지표조회 IndicatorListSearchRequest (1) 지표명별목록조회오퍼레이션명세 오퍼레이션번호 1 오퍼레이션명 ( 국문 ) 목록별지표조회 오퍼레이션유형조회 ( 목록 ) 오퍼레이션명 ( 영문 ) getindicatorlistsearch 오퍼이션정 보 오퍼레이션설명 Call Back URL 목록 ID 로해당지표리스트를조회하는기능 N/A 최대메시지사이즈 [ 800bytes] 평균응답시간 1 초당최대트랜잭션 [ 30tps] 메시지명 ( 영문 ) IndicatorListSearchRequest 호출 메시지타입 변수형 메시지정보 메시지설명 목록ID를검색조건으로입력한다. 선행오퍼레이션 메시지명 ( 영문 ) IndicatorListSearchResponse 응답메시지메시지타입리스트형정보메시지설명호출메시지의검색조건에따라지표목록을제공한다. HTTP Method [ O ] REST (GET, POST, PUT, DELETE) 1 요청메시지명세 메시지명 ( 영문 ) http://kosis.kr/kosisapi/service/indicatorlistservice/indcatorlistsearchrequest 항목명 ( 영문 ) 항목명 ( 국문 ) 유형 샘플데이터 항목설명 LIST_ID 목록ID 필수 A 목록ID 목록ID: 코드표 ([ 링크 ]) 참조 2 응답메시지명세 메시지명 ( 영문 ) IndicatorListSearchResponse 항목명 ( 영문 ) 항목명 ( 국문 ) 샘플데이터 항목설명 IistId 세부목록ID A_01 세부목록ID listnm 세부부문명 인구 세부부문명 47/52
statjipyoid 지표ID 244 지표ID statjipyonm 지표명 주민등록인구 지표명 unit 단위 명 단위 areatypename 지역구분명 시도 지역구분명 prdsename 수록주기명 년 수록주기명 strtprdde 수록시작시점 2000 수록시작시점 endprdde 수록종료시점 2012 수록종료시점 rn 수록시점개수 12 수록시점개수 3 요청 / 응답메시지예제 SOAP( 요청메세지 ) REST(URI) http://kosis.kr/kosisapi/service/indicatorlistse rvice/indicatorlistsearchrequest?list_id=a&servi cekey= 서비스인증키 (URL(UTF-8) encoding) 응답메시지 <?xml version="1.0" encoding="utf-8" standalone="yes"?> - <response> - <header> <resultcode>0000</resultcode> <resultmsg>ok</resultmsg> </header> - <body> - <items> <areatypename> 전국 </areatypename> <endprdde>2012</endprdde> <listid>a_01</listid> <listnm> 주민등록인구 </listnm> <listsn1>1</listsn1> <listsn2>1</listsn2> <prdde>2012년 </prdde> <prdsename> 년 </prdsename> <rn>12</rn> <statjipyoid>244</statjipyoid> 48/52
<strtprdde>2000</strtprdde> <unit> 명 </unit> <areatypename> 시도 </areatypename> <endprdde>2012</endprdde> <listid>a_01</listid> <listnm> 주민등록인구 </listnm> <listsn1>1</listsn1> <listsn2>2</listsn2> <prdde>2012년 </prdde> <prdsename> 년 </prdsename> <rn>12</rn> <statjipyoid>245</statjipyoid> <strtprdde>2000</strtprdde> <unit> 명 </unit> <areatypename> 전국 </areatypename> <endprdde>2013</endprdde> <listid>a_01</listid> <listnm> 추계인구 </listnm> <listsn1>2</listsn1> <listsn2>1</listsn2> <prdde>2013년 </prdde> <prdsename> 년 </prdsename> <rn>53</rn> <statjipyoid>908</statjipyoid> <strtprdde>1960</strtprdde> <unit> 명 </unit> <areatypename> 시도 </areatypename> <endprdde>2013</endprdde> <listid>a_01</listid> <listnm> 추계인구 </listnm> 49/52
<listsn1>2</listsn1> <listsn2>2</listsn2> <prdde>2013년 </prdde> <prdsename> 년 </prdsename> <rn>43</rn> <statjipyoid>273</statjipyoid> <strtprdde>1970</strtprdde> <unit> 명 </unit> <areatypename> 전국 </areatypename> <endprdde>2013</endprdde> <listid>a_01</listid> <listnm> 연령별인구 (0-14세)</listNm> <listsn1>3</listsn1> <listsn2>1</listsn2> <prdde>2013년 </prdde> <prdsename> 년 </prdsename> <rn>53</rn> <statjipyoid>1539</statjipyoid> <strtprdde>1960</strtprdde> <unit> 명 </unit> <areatypename> 전국 </areatypename> <endprdde>2013</endprdde> <listid>a_01</listid> <listnm> 연령별인구 (15-64세)</listNm> <listsn1>3</listsn1> <listsn2>2</listsn2> <prdde>2013년 </prdde> <prdsename> 년 </prdsename> <rn>53</rn> <statjipyoid>1540</statjipyoid> <strtprdde>1960</strtprdde> <unit> 명 </unit> 50/52
<areatypename> 전국 </areatypename> <endprdde>2013</endprdde> <listid>a_01</listid> <listnm> 연령별인구 (65세이상 )</listnm> <listsn1>3</listsn1> <listsn2>3</listsn2> <prdde>2013년 </prdde> <prdsename> 년 </prdsename> <rn>53</rn> <statjipyoid>1542</statjipyoid> <strtprdde>1960</strtprdde> <unit> 명 </unit> <areatypename> 전국 </areatypename> <endprdde>2013</endprdde> <listid>a_01</listid> <listnm> 인구성장률 ( 추계인구기준 )</listnm> <listsn1>5</listsn1> <listsn2>0</listsn2> <prdde>2013년 </prdde> <prdsename> 년 </prdsename> <rn>52</rn> <statjipyoid>1546</statjipyoid> <strtprdde>1961</strtprdde> <unit>%</unit> <areatypename> 시도 </areatypename> <endprdde>2012</endprdde> <listid>a_01</listid> <listnm> 시도별인구증가율 ( 주민등록인구기준 )</listnm> <listsn1>7</listsn1> <listsn2>0</listsn2> 51/52
<prdde>2012년 </prdde> <prdsename> 년 </prdsename> <rn>9</rn> <statjipyoid>1817</statjipyoid> <strtprdde>2003</strtprdde> <unit>%</unit> <areatypename> 시도 </areatypename> <endprdde>2010</endprdde> <listid>a_01</listid> <listnm> 인구밀도 </listnm> <listsn1>8</listsn1> <listsn2>1</listsn2> <prdde>2010년 </prdde> <prdsename> 부정기 </prdsename> <rn>9</rn> <statjipyoid>199</statjipyoid> <strtprdde>1966</strtprdde> <unit> 명 /km²</unit> </items> <numofrows>10</numofrows> <pageno>1</pageno> <totalcount>95</totalcount> </body> </response> ## 이하생략 ## 52/52