콘텐츠로 이동

서비스 통계 목록 개발 명세서

개요

한국은행 경제통계 Open API의 통계표 목록을 조회하는 서비스입니다.

상세주소

요청인자

항목명(국문) 필수여부 샘플데이터 항목설명
서비스명 Y StatisticTableList API 서비스명
인증키 Y sample 한국은행에서 발급받은 오픈API 인증키
요청유형 Y xml 결과값의 파일 형식 - xml, json
언어구분 Y kr 결과값의 언어 - kr(국문), en(영문)
요청시작건수 Y 1 전체 결과값 중 시작 번호
요청종료건수 Y 10 전체 결과값 중 끝 번호
통계표코드 N 102Y004 통계표코드 (선택사항)

요청인자 설명

  • 서비스명: 고정값 StatisticTableList
  • 인증키: 한국은행 Open API에서 발급받은 인증키
  • 요청유형: 응답 형식 (xml 또는 json)
  • 언어구분: 응답 언어 (kr: 국문, en: 영문)
  • 요청시작건수: 페이징을 위한 시작 번호 (1부터 시작)
  • 요청종료건수: 페이징을 위한 종료 번호
  • 통계표코드: 특정 통계표만 조회할 경우 사용 (선택사항)

출력값

항목명(국문) 항목명(영문) 항목크기 샘플데이터 항목설명
상위통계표코드 P_STAT_CODE 8 0000000442 상위통계표코드
통계표코드 STAT_CODE 8 102Y004 통계표코드
통계명 STAT_NAME 200 1.1.1.1.2. 본원통화 구성내역(평잔, 원계열) 통계명
주기 CYCLE 2 M 주기(년, 분기, 월)
검색가능여부 SRCH_YN 1 Y 검색가능여부
출처 ORG_NAME 50 한국은행 출처

출력값 설명

  • 상위통계표코드: 상위 분류 코드
  • 통계표코드: 통계표를 식별하는 고유 코드
  • 통계명: 통계표의 이름
  • 주기: 데이터 수집 주기 (연, 분기, 월 등)
  • 검색가능여부: 해당 통계표 검색 가능 여부 (Y/N)
  • 출처: 통계 데이터 제공 기관명

샘플 URL

https://ecos.bok.or.kr/api/StatisticTableList/{인증키}/xml/kr/1/10/

또는 통계표코드 필터링:

https://ecos.bok.or.kr/api/StatisticTableList/{인증키}/xml/kr/1/10/102Y004

URL 구성 요소

  1. 기본 URL: https://ecos.bok.or.kr/api/
  2. 서비스명: StatisticTableList
  3. 인증키: {인증키} (실제 인증키로 대체)
  4. 요청유형: xml 또는 json
  5. 언어구분: kr 또는 en
  6. 요청시작건수: 1
  7. 요청종료건수: 10
  8. 통계표코드: 선택사항 (예: 102Y004)

메시지 설명

정보 메시지

코드 설명
100 인증키가 유효하지 않습니다. 인증키를 확인하십시오! 인증키가 없는 경우 인증키를 신청하십시오!
200 해당하는 데이터가 없습니다.

에러 메시지

코드 설명
100 필수 값이 누락되어 있습니다. 필수 값을 확인하십시오! 필수 값이 누락되어 있으면 오류를 발생합니다. 요청 변수를 참고 하십시오!
101 주기와 다른 형식의 날짜 형식입니다.
200 파일타입 값이 누락 혹은 유효하지 않습니다. 파일타입 값을 확인하십시오! 파일타입 값이 누락 혹은 유효하지 않으면 오류를 발생합니다. 요청 변수를 참고 하십시오!
300 조회건수 값이 누락되어 있습니다. 조회시작건수/조회종료건수 값을 확인하십시오! 조회시작건수/조회종료건수 값이 누락되어 있으면 오류를 발생합니다.
301 조회건수 값의 타입이 유효하지 않습니다. 조회건수 값을 확인하십시오! 조회건수 값의 타입이 유효하지 않으면 오류를 발생합니다. 정수를 입력하세요.
400 검색범위가 적정범위를 초과하여 60초 TIMEOUT이 발생하였습니다. 요청조건 조정하여 다시 요청하시기 바랍니다.
500 서버 오류입니다. OpenAPI 호출시 서버에서 오류가 발생하였습니다. 해당 서비스를 찾을 수 없습니다.
600 DB Connection 오류입니다. OpenAPI 호출시 서버에서 DB접속 오류가 발생했습니다.
601 SQL 오류입니다. OpenAPI 호출시 서버에서 SQL 오류가 발생했습니다.
602 과도한 OpenAPI호출로 이용이 제한되었습니다. 잠시후 이용해주시기 바랍니다.

사용 예제

XML 형식 요청

curl "https://ecos.bok.or.kr/api/StatisticTableList/YOUR_API_KEY/xml/kr/1/10/"

JSON 형식 요청

curl "https://ecos.bok.or.kr/api/StatisticTableList/YOUR_API_KEY/json/kr/1/10/"

특정 통계표코드 필터링

curl "https://ecos.bok.or.kr/api/StatisticTableList/YOUR_API_KEY/xml/kr/1/10/102Y004"

페이징 처리

# 첫 10개 결과
curl "https://ecos.bok.or.kr/api/StatisticTableList/YOUR_API_KEY/xml/kr/1/10/"

# 다음 10개 결과
curl "https://ecos.bok.or.kr/api/StatisticTableList/YOUR_API_KEY/xml/kr/11/20/"

주의사항

  1. 인증키: 모든 요청에 유효한 인증키가 필요합니다.
  2. 페이징: 요청시작건수와 요청종료건수는 필수이며, 정수값이어야 합니다.
  3. 타임아웃: 검색 범위가 너무 넓으면 60초 타임아웃이 발생할 수 있습니다.
  4. 호출 제한: 과도한 호출 시 일시적으로 이용이 제한될 수 있습니다.
  5. 통계표코드: 선택사항이지만 특정 통계표만 조회할 때 유용합니다.

관련 서비스