답변

KOSIS 공유서비스는 외부(기관, 개인)에서 국가통계포털(KOSIS) 통계정보를 웹 또는 모바일앱 개발에 활용할 수 있도록 인터페이스(API)를 개방․제공하는 서비스입니다. 제공되는 공유서비스 정보는 아래와 같습니다.

1. 1) 통계목록 : KOSIS에서 서비스 되고 있는 통계목록에 대한 정보 및 관련 통계표 정보
   • - 국내통계 주제별
   • - 국내통계 기관별
   • - e-지방지표(주제별)
   • - e-지방지표(지역별)
   • - e-지방지표(테마별)
   • - 광복이전통계(1908~1943)
   • - 대한민국통계연감
   • - 작성중지통계
   • - 국제통계
   • - 북한통계
   • - 대상별통계
   • - 이슈별통계
   • - 영문KOSIS
2. 2) 통계자료* : KOSIS에서 공개되어 서비스되고 있는 통계표의 수치데이터 및 메타정보(분류, 항목, 단위, 수록주기, 수록시점 등)
3. 3) 대용량통계자료* : 상기 2) 통계자료’와 동일한 정보를 제공하나 대량의 자료를 한번에 제공 받으실 수 있으며 신청 후 승인이 필요함
   • * 단, 통계자료 및 대용량통계자료에서 라이선스 제약에 해당하는 일부 국제통계 및 북한통계는 서비스 대상에서 제외됨
4. 4) 통계설명 : 통계조사에 대한 상세정보
   • - 조사명
   • - 적용분류
   • - 통계종류
   • - 조사항목
   • - 계속여부
   • - 공표주기
   • - 법적근거
   • - 공표범위
   • - 조사목적
   • - 공표방법 및 URL
   • - 조사주기
   • - 조사대상기간 및 조사기준시점
   • - 조사체계
   • - 자료이용자 유의사항
   • - 공표범위
   • - 주요 용어해설
   • - 공표주기
   • - 자료 수집방법
   • - 연락처
   • - 조사연혁
   • - 통계(활용)분야·실태
   • - 승인번호
   • - 조사 대상범위
   • - 승인일자
   • - 조사 대상지역
   • - 통계종료
   • - 조사단위 및 조사대상규모
5. 5) 통계표설명 : 통계표에 대한 설명정보
   • - 통계표명칭
   • - 기관명칭
   • - 수록정보
   • - 분류/항목
   • - 주석
   • - 단위
   • - 출처
   • - 가중치
   • - 자료갱신일
6. 6) KOSIS 통합검색 : 국가통계포털(www.kosis.kr)의 통합검색결과
7. 7) 통계주요지표 : 지표 OPEN API 서비스를 이용하기 위한 정보 제공
   • - 지표 고유번호별 설명자료조회
   • - 지표명별 설명자료조회
   • - 목록별 지표조회
   • - 지표정보조회

답변

KOSIS 공유서비스를 활용하려면 국가통계포털 회원으로 가입되어야 합니다. 기존 국가통계포털에 회원으로 가입된 사용자는 그대로 사용하시면 됩니다.
인증키는 회원 당 1개 발급되며, 1개 인증키로 모든 서비스를 이용하실 수 있습니다.
활용신청에 대한 승인은 신청 후 자동승인되어 바로 이용하실 수 있습니다.
서비스 대상별로 이용절차를 안내드리겠습니다.

답변

KOSIS 공유서비스 활용신청에 대한 유효기간은 승인(자동승인 또는 심의승인)된 날로부터 2년입니다. 유효기간이 만료되기 한달 전부터 [마이페이지] 화면에서 유효기간을 연장할 수 있습니다.

답변

서비스 활용신청한 건별로 [마이페이지] 화면에서 활용취소 가능합니다.

답변

KOSIS 통계정보 이용지침 및 활용약관을 준수한다면 KOSIS 공유서비스를 무료로 자유롭게 이용하실 수 있습니다.

답변

답변

KOSIS 공유서비스는 출처표기를 준수하는 조건으로 비상업적 또는 상업적 활용이 모두 가능하며, 재사용 및 재배포도 가능합니다.

단, 라이선스 제약이 있는 국제통계 및 북한통계는 예외적으로 비상업적 목적으로만 사용하여야 하며 이 경우에도 재배포는 금지되오니 유의하시기 바랍니다.

(KOSIS 통계정보 이용지침 참고)

답변

KOSIS 통계자료는 상업적 활용이 가능하나, 라이선스 제약이 있는 국제통계 및 북한통계의 경우는 비상업적(비영리) 활용만 허용하고 있습니다. (재배포 또한 불허)

국제통계 및 북한통계의 통계표 리스트를 붙임으로 안내하오니 참고하시기 바랍니다.

아울러, KOSIS 공유서비스의 통계자료 및 대용량 통계자료 이용화면에서 국제통계 및 북한통계에는 통계표명에 비영리 아이콘(이미지)으로 별도 표시하였으니 참고하시기 바랍니다.

붙임 1. 국제통계 리스트

붙임 2. 북한통계 리스트

답변

KOSIS 공유서비스 활용 시 준수사항은 아래와 같습니다.

• - 통계정보를 임의로 변경하거나 왜곡하지 않아야 합니다.
• - 통계정보나 통계정보의 출처를 잘못 기재하지 않아야 합니다.
• - 관련 법률을 침해하거나 위반하지 않는 범위 내에서 활용해야 합니다.
• - 개인, 사업체, 특정조직을 식별할 목적으로 다른 정보와 연결하거나 링크하지 않아야 합니다.
    또한, 서비스 관련 <책임과 한계>는 아래와 같으므로 서비스 이용에 유의하시기 바랍니다.
• - 통계청은 정확하고 시의적절한 통계정보를 제공하기 위해 모든 노력을 기울이고 있습니다.
• - KOSIS에 수록된 통계정보는 이용자에게 통보 없이 추가, 변경, 개선, 업데이트될 수 있습니다.
• - 통계청은 KOSIS에 수록된 통계정보에 포함된 오류, 누락 등 정보의 품질 또는 정보의 활용으로 인한 손해․손실에 대한 책임을 부담하지 않습니다.
    또한, 서비스 장애 등으로 발생한 활용자의 손해에 대한 책임을 지지 않습니다.
• - 통계청은 KOSIS 통계정보를 매개로 제3자와 발생한 분쟁에 대하여 개입할 의무가 없음을 알려드립니다.
• - KOSIS 통계정보(통계수치와 의미)를 임의로 변경하여 이용하거나 배포할 경우에는 형사처벌을 받을 수 있습니다.
• - KOSIS 통계정보의 이용에 대한 책임은 전적으로 이용자에게 있음을 알려드립니다.

답변

KOSIS 공유서비스 자료 제공형태 중에서 SDMX는 XML의 일종으로서 통계에 특화된 XML로 보시면 됩니다.

SDMX는 Statistical Data and Metadata eXchange의 약어로 통계작성기구(기관)간의 다양한 형태의 통계자료를 XML 기반으로 제공하여 교환과 공유를 효율적으로 지원합니다.

SDMX 표준은 국제결제은행(BIS), 유럽중앙은행, 유럽통계처(Eurostat), 국제통화기금(IMF), 경제협력개발기구(OECD), UN 통계국 및 세계은행의 국제기구들로부터 후원을 받고 있습니다.

현재 Version 2.1은 2013년 1월에 ISO(국제표준화기구) 17369로 국제표준 인증을 받았으며 각 국의 통계청과 여러 국제기구에 이르기까지 사용범위가 점차 확대되고 있습니다.

SDMX 표준 및 지침, 개발도구(software), 새로운 소식 등은 현재 SDMX.org 웹사이트를 통해 제공되고 있습니다.

SDMX 파일에 대한 설명(SDMX Version 2.1)

SDMX 파일에 대한 설명(SDMX Version 2.1)

구분	설명
DSD	Data Structure Definition의 약어로 통계자료에 대한 의미와 구조를 정의하고 있습니다. 통계청의 통계표를 예를 들면 통계표에 대한 설명과 통계표의 형태를 파악할 수 있는 통계표의 구성정보와 분류, 분류값, 단위, 항목에 대한 상세정보(코드 및 명칭)를 담고 있습니다.
DATA	DATA 파일은 DSD에서 정의한 구성정보에 주기, 시점에 따른 수치정보를 정의하고 있습니다. SDMX version 2.1에서는 Generic, StructureSpecific 두 가지 포맷으로 나뉘어져 있으며 이들 포맷사이에는 XML의 형태가 다르다는 차이점이 있습니다. - Generic : 데이터를 담는 XML 구성요소가 구조를 정의하는 메세지와 독립적인 형태로 이루어져 있으며 통계구성정보 및 수치정보가 각 Element(요소, 항목)로 구성되어 있어 파일크기가 StructureSpecific에 비해 큽니다. - StructureSpecific : 데이터를 담는 XML 구성요소는 구조를 정의하는 메세지에 의존적인 형태로 이루어져 있으며 통계구성정보 및 수치정보는 하나의 Element(요소, 항목)에 Attribute(속성)로 나열되어 있어 파일크기가 Generic에 비해 작습니다.

답변

서비스 대상별로 자료 제공형태는 아래와 같습니다.

서비스 대상별로 자료 제공형태

<서비스 대상>	<자료 제공형태>
통계목록	JSON, SDMX
통계자료	JSON, SDMX
대용량통계자료	XLS, SDMX
통계설명	JSON, XML
통계표설명	JSON, XML
KOSIS 통합검색	JSON
통계주요지표	JSON, XML

답변

오류유형별 설명은 아래와 같습니다.

오류유형별 설명

<오류 번호>	<오류 설명>
(10)	(인증키 누락) 사용자의 인증키가 누락되었을때 발생하는 오류입니다. 인증키를 확인하시기 바랍니다.
(11)	(유효하지 않은 인증키) 활용신청하지 않은 사용자의 인증키이거나 인증키가 잘못되었을 경우 발생하는 오류입니다. 인증키를 확인하시기 바랍니다.
(12)	(인증키 기간만료) 사용자의 인증키 사용 기간이 만료되었을 경우 발생하는 오류입니다. 인증키 이용기간은 2년이며, 만료일 한 달 전부터 [마이페이지]에서 연장 하실 수 있습니다. 이미 만료된 경우는 활용신청을 다시 하셔야 합니다.
(20)	(필수요청변수 누락) 기관코드, 통계표ID 등 필수요청변수가 누락되었을 경우 발생하는 오류입니다. 개발가이드를 참고하여 필수요청변수를 확인하시기 바랍니다.
(21)	(요청변수값이 잘못됨) 요청변수에 값이 없거나(null), 허용되지 않은 값이 포함되었을 경우 발생하는 오류입니다. 개발가이드를 참고하여 요청변수값을 확인하시기 바랍니다.
(30)	(데이터 없음) 호출한 자료가 없는 경우 발생하는 오류입니다. 조회조건을 확인하시기 바랍니다.
(31)	(조회결과 초과) 호출한 자료가 데이터가 40,000건 이상으로 제한되어 발생하는 오류입니다. 데이터건수를 조정해 주세요.
(40)	(호출가능건수 제한) 호출 건수가 설정된 건수 이상으로 호출되어 발생하는 오류입니다. 호출건수를 조정해 주세요.
(41)	(호출가능데이터수 제한) 호출한 자료가 설정된 데이터수 이상으로 호출되어 발생하는 오류입니다. 데이터건수를 조정해 주세요.
(42)	(사용자별 이용 제한) 이용이 제한된 IP 또는 인증키 사용 시 발생하는 오류입니다. 관리자에게 문의하시기 바랍니다.(☎ 042-481-2432)
(50)	(서버오류) 시스템 및 네터워크의 문제로 일시적으로 발생한 오류입니다. 재호출 시에도 동일하게 서버오류가 나타나면 관리자에게 문의하시기 바랍니다.(☎ 042-481-2432)

답변

KOSIS 공유서비스는 국가통계포털의 회원과 동일합니다.

회원가입 방법은 KOSIS 공유서비스의 회원가입 메뉴를 이용하시거나, KOSIS(http://kosis.kr)의 회원가입 메뉴를 이용하시면 됩니다.

회원가입 바로가기

답변

KOSIS 공유서비스 회원정보는 국가통계포털 회원정보와 동일하게 관리하므로, KOSIS(http://kosis.kr)에서 회원정보수정 및 회원탈퇴를 하시면 됩니다.

* KOSIS 회원정보수정 및 회원탈퇴 방법 : 로그인 > 마이페이지 > 회원정보수정 및 회원탈퇴