[무역|5|API] 니트릴장갑 수출입 - 공공데이터포털 API 활용신청 (2부)

[무역|5|API] 니트릴장갑 수출입 - 공공데이터포털 API 활용신청 (2부)

 

 

 먼저, 공공데이터포털의 활용신청 방법에 대한 간략 설명을 보시겠습니다.

 

개발계정신청과 운영계정신청

 

 

 

 

 

 

 

 개발계정은 서비스나 애플리케이션 개발자가 개발을 목적으로 데이터를 활용할 목적으로 신청하는 계정인데요. 이용자가 사용하는 것이 아니고 개발 차원에서 코드 테스트 과정 등을 하는 것이기 때문에 트래픽을 크게 발생할 일이 많지 않을 것입니다. 하여, 하루 평균 1000건 규모의 트래픽을 제공한다고 하는데요. 이 정도면 아직 개발할 서비스를 대중에 공개할 수준의 구체적 개발 목적을 가지고 개발하지 않는 이상은 충분한 수준입니다.

 

 

 

 

 

 

 

 

 운영계정은 서비스나 애플리케이션을 개발하여 최종사용자가 사용할 수 있는 형태로 서비스를 제공하게 되었을 때 해당 서비스 운영을 목적으로 한 계정입니다. 실제 공공데이터를 대중이 바로 접하고 사용하도록 운영하기 위한 계정이므로 트래픽은 하루 최대 10만 건까지 보장해 주고 있습니다.

 

 

 

 

 

 

 

 

 

 개발계정이나 운영계정 신청을 하게 되면 오픈API 활용신청에 대한 승인요청이 진행됩니다. 승인은 '자동승인'과 '심의승인'이 있다고 하는데요. 데이터의 상업적 이용이 적합한지, 국가기밀상 대중에게 공개가 적합한지 등을 평가가 필요한 항목이라면 '심의승인'하도록 되지 않을까 추정됩니다. 필자가 독자님들과 함께 살펴볼 주제들은 그에 미치지 못하는 경우가 대부분이라 봅니다. 특히, 관세청의 '품목별 수출입실적'과 '품목별국가별 수출입실적' 또는 수입원가정보공개상의 자료가 주를 이룰 것으로 생각되는데요. 이 정도는 '자동승인'이 가능한 일반적인 데이터에 분류됩니다.

 

 

 그러면, 실제 신청을 통해 진행을 살펴보시겠습니다.

 

 

 

 

 

 관세청 '품목별 수출입실적' 오픈 API 활용신청 예시

 

 

 이제 필자가 자주 다루는 주제인 무역분야. 특히, 가장 조회가 잦은 '품목별 수출입실적'에 대한 오픈 API 신청을 실행해 보겠습니다. 

 

 먼저 공공데이터포털에서 '품목별수출입실적'으로 조회를 해보겠습니다.

 그리고 오픈 API탭으로 이동하시면 아래와 같은 항목이 나오는데요. 두번째의 품목별 수출입실적항목을 선택해서 들어가 보겠습니다.

 

 

 

 

 

 

 오픈 API 상세가 나옵니다. 1) 제공기관은 어디인지 2) 데이터포맷은 무엇인지 3) 심의유형은 어떻게 되는지 4) 비용부과유무 그리고 5) 이용허락범위 정도는 잘 살펴 보실 필요가 있습니다.

 

 그리고 6) 참고문서는 해당 링크를 클릭해 가급적 받아두시길 권장 드립니다. 실제 항목 활용등을 위해서 해당 자료에 포함된 내용을 참조해야할 필요가 있기 때문에 중요합니다.

 

 

 

 

 

 

 

 

 

 그 다음으로 내려가 보시면 요청변수와 출력결과에 대한 내용이 나옵니다. 

 

 당장은 모르셔도 되겠지만, 코드작성단계로 넘어가게 되면 매우 중요한 참조값들입니다. 

 

 1) 요청변수는 공공데이터포털이 인터페이스를 만들어서 제공하는 '조회기간' 및 '품목코드' 값을 설정하기 위해 지정되어 있는 변수 입니다. 해당 변수명으로 우리의 코드를 작성하여야 합니다. 항목크기/샘플데이터도 필수참조사항입니다. 해당 자료형식에 맞추어 변수에 우리가 원하는 검색조건값을 대입하여야 하기 때문입니다.

 

 2) 출력결과는 값이 어떻게 표출되는지 항목명 값과 항목크기 등을 알려 주는 것입니다. 샘플데이터를 잘 참조하여 결과물이 어떻게 출력되는지 살펴볼 것입니다.

 

 

 

 

 

 

 

 

 더 내려가보시면 샘플코드가 나옵니다.

 

 python 버튼을 눌러보시면 예제문이 나오는데, 해당 예제문으로 API에 의해 읽어 들이게 되는 결과물을 출력해 볼 수 있습니다. 그런데, 구글링 도중 살펴보니, 일부 항목의 경우에서 python 2.x 버전의 코드로 샘플코드가 제공되는 경우가 있다고 합니다. 현재 python 3.8대가 나와 있고, 필자도 python 3.8대를 사용하고 있는데요. 

 

 오래되어 유효하지 않은 코드가 샘플코드로 제시될 수도 있는 점 참조하셔서, 그저 참조로만 보시는 것이 나으실 것 같습니다.

 

 

 

  

 

 

 

 

 

 이제 신청을 위한 필요정보는 대충 살펴 보았으니, 활용신청 버튼을 눌러 보겠습니다.

 

 

 

 

 

 

 

 

 

 오픈API 개발계정신청 화면으로 넘어갑니다.

 

 저는 이미 '품목별 수출입실적'에 대해서는 활용신청을 완료하였기 때문에, '품목별 국각별 수출입실적'으로 이미지 캡쳐하여 올린 점 양해 부탁 드립니다. 화면상의 차이는 전혀 없으니, 똑같이 진행해 주시면 됩니다.

 

 

 '자동승인'항목으로 '승인일로부터 24개월간 활용가능하다'는 것이 확인됩니다

 활용목적은 필수 입력 항목이니 반드시 입력해 주셔야 겠습니다. 

 당장은 서비스 개발할 것이 아니니, 참고자료로 쓰겠다는 의미에서 참고자료를 선택하겠습니다.

 

 

 

 

 

 

 

 

 

 

 그 아래로 이동하시면 시스템 유형 선택이 나옵니다. 읽어 보시고, 서버를 구축하시고자 하시는 경우엔 서버구축을 선택하시면 됩니다. 이용허락범위는 동의표시하였습니다.

 

 

 

 

 

 

 

 

 이렇게 해서 신청서 작성은 매우 간단하게 완료 됩니다.

 

 활용신청 버튼을 눌러 보겠습니다.

 

 신청이 완료되었다는 메시지가 나오고, '마이페이지'로 이동됩니다.

 

 

 

 

 

 

 

 

 

 

자동승인이기 때문에, 신청건에 집계되지 않고 활용건에 집계가 됩니다.

 

승인 된 것이 확인됩니다.

 

 

 

 

 

 

 

 

 

이제 API에 의한 자료 이용 승인이 되었으니, 다음 포스팅에서 해당 API로 자료를 받아 활용하기 위한 코딩을 진행해 보겠습니다.

 

 

(3부에서 계속..)

 

 

NPU(엔피유) 관세사무소

대표관세사 고장주

Tel) 031-986-7190

E-mail) sales@npucus.com

[NPU관세사무소 프로모션 페이지] https://www.tradenpu.com/npu_cus/

[무역비지니스 인텔리전스 서비스 | TradeNPU] https://www.tradenpu.com​

[파이썬 실용 예제. 무역과 공공데이터] https://pdatinmylife.tistory.com

​

Certified Customs Broker JangJu Goh

Executive Customs Broker @ NPU Customs Consulting

CEO @ JG TradePlus

​

sales@npucus.com

Trade Compliance / Customs clearance management at foreign company

Working experience of Air export freight forwarding

Data Visualization / Independent development of business automation application – copyright of JGPO_Manager, JG Data Center, AutoCC and etc.

B2B consignment & direct export/import, B2C Overseas Buying Office consulting

Alibaba.com B2B trade / taobao B2C trade / Amazon.com global selling etc. Online trade regulation consulting.

Import license / Quarantine

English communication available

​

[TradeNPU for partnership proposal - JGTP] https://www.tradenpu.com/jgtp/