대메뉴바로가기 본문바로가기

KOTRA 해외시장뉴스

통합검색

API

1. Open API 이용안내

Step 1회원가입

  1. 한국정보화진흥원 공공데이터포털을 통해 회원가입을 합니다.
  2. 개인은 일반회원, 기관 및 민간기업은 기관회원으로 가입합니다.
  3. KOTRA에서 제공하는 무역관련 OpenAPI 서비스를 이용하기 위해서는 공공데이터포털에 회원가입을 해야 합니다.
    공공데이터포털 회원가입 이미지

Step 2개발계쩡신청 및 심의

  1. 데이터셋 > 오픈API를 통해 KOTRA가 제공하는 OpenAPI 서비스 목록을 확인합니다.
    공공데이터포털 기관별 검색 이미지
  2. 이용하고 싶은 서비스를 클릭하여 서비스의 상세정보를 확인하고, 활용신청 버튼을 클릭하여 신청합니다.
    공공데이터포털 상세정보 확인 이미지
  3. 인증유형, 활용용도, 활용목적, 상세기능, 표준약관 동의는 필수 사항입니다.
    공공데이터포털 개발계정신청 이미지
  • * 개발 계정이란? 실제 운영하기 전 API를 활용하여 테스트 및 개발을 하기 위한 단계
  • * 개발계정이기 때문에 일일 트래픽(1,000건)을 초과하여 활용할 수 없습니다.
  • * 심의에서 신청 내용이 미완성일 경우 반려 또는 보류될 수 있습니다.

Step 3서비스 키 발급

  1. 마이페이지에서 인증키 받기 버튼을 클릭하면 인증키를 발급받을 수 있습니다.
    공공데이터포털 개발계정 상세보기 이미지
  • * 서비스키는 재발급 신청이 가능합니다. (기존 서비스키는 자동 폐기)
  • * 개발 계정을 신청하게 되면 심의를 거쳐 서비스키가 발급 됩니다.
  • * 서비스키는 1인당 하나만 발급되며 서비스키를 통하여 모든 공공데이터포털 OpenAPI를 활용할 수 있습니다.

Step 4운영계정 신청 및 심의

  1. 운영 계정(테스트 계정)활용 신청
    공공데이터포털 운영계정 신청 이미지
  2. 운영계정은 KOTRA 담당자의 승인이 필요하며, 약 1~2일 정도 소요됩니다.
    (API 등록시 수동으로 했을 때, 만약에 자동으로 하시면 이 단계는 필요 없습니다.)
    • 운영 계정이란? 실제 서비스를 진행하기 위한 단계
    • 운영 단계 신청 시 필요한 트래픽을 활용자가 작성할 수 있습니다.
    • 개발된 어플리케이션에 대한 활용사례를 등록해야 합니다.
    • 심의에서 신청 내용이 미완성일 경우 반려 또는 보류될 수 있습니다.
    • 운영 계정 승인 요건
      1. 1. 개발 계정으로 테스트 이력(로그) 확인
      2. 2. 파라미터 “mobileApp”값에 서비스 고유명 확인
      3. 3. 서비스 되는 앱/웹에서 Kotra API 적용 확인
      4. 4. 개발 계정, 운영 계정, 서비스키 등의 진행 및 활용정보는 공공데이터포털 마이페이지에서 확인할 수 있습니다.

Step 5OpenAPI 활용

  1. OpenAPI 활용
  2. 제공된 kotra Open API를 활용하여 다양한 매쉬업 서비스를 만들 수 있습니다. 활용을 위해 공공데이터포털에서 개발가이드, 온라인 매뉴얼, 다양한 활용사례를 제공합니다.

Step 6OpenAPI 이용시 준수사항

  1. 원저작물 표기와 원문 훼손 금지는 공공누리 유형별 활용범위를 준수하여야 합니다.
  2. 공공누리 유형에도 불구하고 이미지, 통계 등 공사가 저작권을 갖고 있지 않고 별도 출처를 명기한 외부 자료는 해당 자료원의 사용허가를 취득하여 사용하여야 합니다.
  3. 대한무역투자진흥공사에서 제공하는 Open API를 사용하지 않고, 홈페이지의 자료를 무단으로 캐싱(로컬 서버에 저장)하여 사용 금지합니다.
2. 코트라에서 제공하는 API 및 파일 목록
· API 목록
개방 형태, 데이터명, 데이터 포맷을 알 수 있는 표 입니다.
개방 형태 데이터명 데이터 포맷
REST 국가정보 XML,JSON
REST 해외시장뉴스 XML,JSON
REST 상품 DB XML,JSON
REST,FILE GCL(글로벌역량진단) XML,JSON,EXCEL 파일
REST 해외시장 데이터 XML,JSON
REST,FILE 무역투자상담 데이터 XML,JSON,EXCEL 파일
REST,FILE 무역사기사례 XML,JSON,EXCEL 파일
REST,FILE 기업성공사례 XML,JSON,EXCEL 파일
REST,FILE 해외유망프로젝트 XML,JSON,EXCEL 파일
FILE 해외전문조사기관 EXCEL 파일
FILE 해외기업검색사이트 EXCEL 파일
FILE 해외진출기업 EXCEL 파일
LINK 해외투자법규, 서식 PDF 파일