이 누리집은 대한민국 공식 전자정부 누리집입니다.
- 현재 금융위원회(금융공공데이터담당관)에 자주 문의되고 있는 질문과 답변을 정리하였습니다.
- - 별도 질문이 있는 경우 금융공공데이터담당관(담당자 김채리 주무관, ☎02-2100-2675)으로 연락을 주시기 바랍니다.
-
- 금융위원회에서 제공하는 API 서비스는 데이터 제공기관으로부터 데이터를 연계받아 수집 후 개방하고 있습니다.
- 데이터 제공기관의 영업 종료 이후 최종 데이터를 익일 새벽에 연계받아 정제 처리 후 당일 13시 이후에 개방하고 있으므로, 모든 데이터는 실시간이 아닙니다. ※ 주말 및 공휴일에는 영업하지 않으므로 모든 데이터는 다음 최초 영업일에 개방됩니다. (ex. 금요일의 원천 데이터는 차주 월요일에 제공)
- 데이터 제공기관 별로 연계 시간이 상이하여 일부 데이터는 13시 이전에도 조회가 가능할 수 있으나, 안정적인 전체 데이터를 조회하시기 위해서는 13시 이후에 조회하실 것을 권장드립니다. ※ 실시간 데이터 제공은 데이터 제공기관·민간 서비스와의 중복 및 사업 영역 침해 우려로 현재 제공되지 않는 점 참고하시기 바랍니다.
-
- numOfRows는 한 페이지당 조회 건수를 의미하며, 최대 10,000건까지 설정 가능합니다. 따라서 10,000건 이상으로 설정한 경우에도 실제 응답은 최대 10,000건이 조회됩니다.
- pageNo는 조회 결과의 페이지 번호를 의미하며, 전체 데이터를 여러 페이지로 나누어 조회할 때 사용됩니다.
- 예를 들어, 전체 데이터가 30,000건인 경우 하단과 같이 페이지를 나누어 조회하실 수 있습니다.
numOfRows=10000, pageNo=1 : 1~10,000건
numOfRows=10000, pageNo=2 : 10,001~20,000건
numOfRows=10000, pageNo=3 : 20,001~30,000건 - 대량 조회 시에는 상기 예시처럼, pageNo 값을 증가시키며 호출하는 방식으로 이용해 주시기 바랍니다.
-
- API는 60초 이상 응답이 지연될 경우 공공데이터포털 측에서 연결을 종료(타임아웃) 처리하고 있습니다.
- 이때 별도 조건(파라미터) 설정 없이 조회 요청하는 경우, 전체 데이터 스캔이 필요하므로 처리 시간이 걸어져 응답 지연 또는 타임아웃이 발생할 수 있습니다.
- 원활한 이용을 위하여 기준일자, 종목코드 등 조건(파라미터)을 설정하여 조회 요청해 주시기 바라며, numOfRows 및 pageNo를 활용하여 데이터를 분할 조회하실 것을 권장드립니다. (→자주 묻는 질문 2번 참고)
-
- 403 Forbidden / 401 Unauthorized 오류는 서비스키 인증과 관련된 오류이므로, 다음 순서에 따라 조치하여 주시기 바랍니다.
- 1) 종종 일시적인 오류가 발생하기도 하므로, 우선 약 20분 후 재시도 하실 것을 권고드립니다.
- 2) 재시도 이후에도 동일한 오류가 지속될 경우, 이는 서비스키의 문제일 가능성이 있으므로 변경신청 진행 후 약 1시간 후에 이용을 부탁드립니다.
* 변경신청 경로 : 마이페이지 > 데이터 활용 > OPEN API > 활용신청 현황 >
해당 OPEN API 선택 > 하단 변경신청 버튼 클릭 - 3) 만약 변경신청 후 1시간 후에도 Forbidden / Unauthorized 오류가 발생하신다면, 공공데이터포털 측으로 상세 문의하여 주시기 바랍니다.
-
- 개발계정과 운영계정은 제공되는 데이터가 동일하지만, 일일 호출 가능 건수(트래픽)에 차이가 있습니다.
* 개발계정 : 일일 최대 10,000건 / 운영계정 : 일일 최대 100,000건 - 이때 일일 호출 가능 건수를 초과할 경우 추가 호출 시 오류가 발생하며, 다음 날에 다시 일일 호출 가능 건수(트래픽) 내에서 이용이 가능합니다.
- 다만, 트래픽 초기화는 자정(0시)에 일괄 초기화되는 방식이 아니라, 시스템 처리에 따라 순차적으로 반영되므로 정확한 초기화 시점을 예측하기는 어려운 점 참고하시기 바랍니다.
- 개발계정과 운영계정은 제공되는 데이터가 동일하지만, 일일 호출 가능 건수(트래픽)에 차이가 있습니다.
-
- 최초개방일자와 최종개방일자의 의미는 다음과 같습니다.
- 최초개방일자 : 해당 데이터가 처음 등록된 일자
- 최종개방일자 : 해당 데이터가 마지막으로 개방(갱신)된 일자 - 따라서 최초개방일자와 최종개방일자를 통해 데이터의 변경 이력을 확인하실 수 있고, 최종개방일자가 가장 최근인 데이터를 기준으로 최신 데이터를 확인하실 수 있습니다.
- ※ ‘금융위원회_기업기본정보’의 경우 여러 기관으로부터 데이터를 수집하여 개방하고 있습니다. 초기에는 일별 데이터를 누적하는 방식으로 제공하였으나, 데이터의 양이 급증함에 따라 응답시간 지연 및 연결 오류가 발생하는 문제가 있었습니다. 이에 따라 현재는 데이터 변경이 발생한 경우에만 신규 데이터가 생성되는 방식으로 제공하고 있으니, 이용에 참고하시기 바랍니다.
- 최초개방일자와 최종개방일자의 의미는 다음과 같습니다.
-
- 네, 데이터별 ‘이용허락범위 유형’에 따라 제한적으로 이용 가능합니다. (데이터별 ‘이용허락범위 유형’에 따라 출처 표기나 상업적 이용 제한)
- 원칙적으로는 영리 목적의 이용을 보장하지만, 출처 표기를 누락하거나 일부 상업적 이용 불가 데이터를 무단으로 사용할 경우 법적 책임이 따를 수 있으므로, 이용 전 공공데이터포털 API 상세 페이지의 이용허락범위 유형을 반드시 확인해 주시기 바랍니다.
* 이용허락범위 유형
- 제 1유형 : 출처 표시
- 제 2유형 : 출처 표시 + 상업적 이용 금지
- 제 3유형 : 출처 표시 + 변경 금지
- 제 4유형 : 출처 표시 + 상업적 이용 금지 + 변경 금지
※ 이용허락범위에 대한 상세 안내 : https://www.data.go.kr/ugs/selectPortalPolicyView.do
-
- 1. (원천) ‘금융표준종합정보시스템’은 금융감독원 등 9개 산하기관으로부터 외감 및 비외감 대상 법인의 주요 데이터를 수집하여 개방중입니다.
- 외감대상 법인은 금융감독원, 산업은행, 신용보증기금, 기업은행이 보유한 데이터를 수집하며, 조회하려는 법인의 데이터가 2개 이상의 기관에서 수집된 경우 금융감독원 데이터가 조회됩니다.
- 비외감대상 법인은 산업은행, 신용보증기금, 기업은행이 보유한 데이터를 수집하며, 조회하려는 법인의 데이터가 2개 이상의 기관에서 수집된 경우 중소기업은행 데이터가 조회됩니다. - 2. (보유기간) 기업개요는 가장 최신의 정보가 조회되며, 보유기간의 제한은 없습니다.
- 1. (원천) ‘금융표준종합정보시스템’은 금융감독원 등 9개 산하기관으로부터 외감 및 비외감 대상 법인의 주요 데이터를 수집하여 개방중입니다.
-
- 1. ‘기준일자’는 데이터가 유효한 최초 시점의 일자로,
- ① 원 데이터가 실제로 생성되어 산하기관에 입력된 일자 또는
- ② 원 데이터의 생성일자가 명확치 않은 경우, 금융표준종합정보시스템 DB에 데이터가 생성된 시점의 일자입니다.(통상 산하기관에서 금융표준종합정보시스템으로 데이터를 송신한 일자)
- 2. 데이터 갱신은 산하기관의 데이터 송신 및 배치처리작업이 마감되는 시점(약 14시)에 이루어집니다.
- 1. ‘기준일자’는 데이터가 유효한 최초 시점의 일자로,
-
- 보도자료에 나온 비외감법인 데이터 58만 건은 현재 금융공공데이터를 통해 조회가능한 비외감법인의 총 개수를 의미하는 것으로,
‘금융위원회_기업기본정보’ 오픈 API 중 ‘기업개요조회’ 기능에서 조회 가능한 비외감법인의 총 개수를 의미합니다.
- 보도자료에 나온 비외감법인 데이터 58만 건은 현재 금융공공데이터를 통해 조회가능한 비외감법인의 총 개수를 의미하는 것으로,
-
- 비외감법인 데이터는
- ① 금융위원회_기업기본정보 오픈 API 중 기업개요조회
- ② 기업재무정보 오픈 API 중 요약재무제표조회 총 2개 기능에서 확인할 수 있습니다.
- - 비외감법인 데이터만을 따로 구분하여 조회할 수 없으며, 위 기능에서 외감법인과 비외감법인을 모두 포함한 데이터를 조회할 수 있습니다.
- 비외감법인 데이터는
-
- 요청변수 중 인증키, 페이지번호, 한 페이지 결과 수를 제외한 나머지 변수를 공란으로 두고 요청한 결과, ‘totalCount’ 항목으로 조회되는 숫자가 해당 기능의 전체 데이터 개수입니다.
-
< 예시 : 기업기본정보 오픈 API 중 기업개요조회 기능 >
-
- 원칙적으로 프로그램‧데이터 구성 및 공공데이터포털(이하 “포털”) 정책에 따라 기능별로는 한 번에 수신이 가능하나, 오픈 API별로는 수신이 불가합니다.
- 기능별로 수신하기 위해서는 우선 필수 변수*만으로 기능을 호출하여 ‘전체결과수’(‘totalCount’) 변수상의 전체 데이터 개수를 확인 후, 이를 다시 ‘한페이지결과수’(‘numOfRows’) 변수**에 입력하여 호출하는 방식으로 한 번에 수신 가능합니다.
* 인증키, 페이지번호, 한 페이지 결과수, 결과형식 등
** 한번의 기능 호출로 수신할 전체 수신할 데이터 수 - 다만, 다량 데이터 호출시 포털의 타임아웃 정책에 따라 1분내 데이터를 미수신할 경우, 에러가 발생되므로 만약 타임아웃 에러 등이 발생할 경우, ‘한페이지결과수’ 변수의 값을 조절하여 재시도하시기 바랍니다.
-
- 채권기본정보의 기본 처리키 값은 법인등록번호이며 사업자등록번호는 산하기관의 관리 대상 정보가 아닙니다.
- 따라서 현재 사업자등록번호로 조회하는 기능은 제공이 불가능합니다.
-
- 기업재무정보내의 재무상태표 조회를 이용하면 계정과목명과 계정과목금액을 알 수 있으며, 이를 이용하면 유동자산 및 유동부채를 계산할 수 있을 것입니다.
- * 금융공공데이터는 활용에 필요한 기본 데이터를 제공하는 것이며 이를 활용하여 유용한 정보를 생성하는 것은 데이터 이용자의 역할이오니 API 활용에 참고하시기 바랍니다.
-
- 모든 공공데이터포털의 API는 공공데이터포털과 사용자간 통신으로 작동되므로 금융위 API 활용을 위해 별도로 설정해야할 방화벽 정책 등은 없습니다.
- 필요시 공공데이터포털( http://www.data.go.kr )에, 통신을 위한 방화벽 정책 설정 등을 문의하시기 바랍니다.
-
- 1. (의미) 금융감독원의 주채무계열, 공정관리위원회의 공시대상기업집단 및 산업은행이 일정규모의 신용공여를 제공하는 기업집단 등에 대한 특정 기준의 기업집단별 계열회사 조회를 의미합니다.
- -만약 2개 이상의 기준이 경합할 경우, 주채무계열 → 공시대상기업집단 → 산은 신용공여 제공 집단 順으로 조회됩니다.
- 2. (조회방법) 호텔신라의 계열회사 정보 조회를 원한다고 가정시,
- ① 우선 ‘기업개요조회’ 기능의 법인의 명칭(‘corpNm’)에 호텔신라를 조회하여 관련 법인등록번호(‘crno’) 정보를 취득하고,
- ② 이후 ‘계열회사조회’ 기능에서 해당 법인등록번호를 기입하여 조회하면 삼성중공업, 에이치디씨신라면세점 등 동일 기업집단의 계열회사 정보가 조회됩니다.
- 1. (의미) 금융감독원의 주채무계열, 공정관리위원회의 공시대상기업집단 및 산업은행이 일정규모의 신용공여를 제공하는 기업집단 등에 대한 특정 기준의 기업집단별 계열회사 조회를 의미합니다.
-
- 이용 보장의 의미는 이용자가 공공기관이 제공한 공공데이터의 사실적 내용을 유지하는 범위에서 자유롭게 가공·활용할 수 있다는 것이지, 공공데이터의 사실적인 내용을 위·변조 및 왜곡하여 사용하는 것까지 보장하는 것은 아닙니다.
- 이용자가 공공데이터의 이용 요건을 위반하거나 범죄 등의 불법 행위에 악용한 경우 공공기관은 제공 중단, 과태료 부과와 같은 조치를 취할 수 있습니다.