인천항만공사_인천항 신고정보 조회 서비스

해당 데이터는 인천항만공사에서 운영중인 화물 반출입 시스템에서 인찬항의 통합 화물 반출입, 내외항 화물 반출입, 내외항컨테이너 반출입, 위험물 신고 정보 조회 서비스를 Open API 형태로 제공합니다. 주요 요청 파라미터로는 numOfRows, blNo, callLetter, agentCode, mrnNo, serNo, yyr등이 있으며, 응답 필드는 B/L 번호, MRN 번호, 선박 호출부호, 선사코드, 신고일자, 입항연도, 신고유형 코드 등이 포함되어 있습니다. 이 Open API는 REST 방식으로 작동하며, XML 형태로 응답을 반환합니다. 인증키(serviceKey)를 필요로 하며, 총 13개의 요청변수와 14개 이상의 응답 필드를 통해 인천항을 통한 수입/수출 절차의 데이터를 통합적으로 확인할 수 있습니다.

body header BL번호 MSN번호 item items 결과메세지 결과코드 데이터 총 개수 반입구분 반입구분명 선박고유키 선박명 선석SUB코드 선석코드 수리구분 수리일시 수출입구분명 순번 신고일시 업체명 업체코드 일련번호 입출거구분 입출거구분명 입출항일자 입항년도 적하목록관리번호 청코드 페이지 수 한 페이지당 표출 데이터 수 호출부호 화물구분 화물코드

주소는 예시입니다 — 이 API의 실제 호출 주소는 공공데이터포털이 로그인 뒤에만 공개해서 자동으로 가져올 수 없습니다. 파라미터 이름은 확실하니, 주소만 원문 활용가이드에서 확인해 채우십시오.

curl -G 'https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}' \
  --data-urlencode 'serviceKey=발급받은_인증키' \
  --data-urlencode 'BL번호=값' \
  --data-urlencode '수출입구분=값' \
  --data-urlencode '신고일자 from=20260101' \
  --data-urlencode '신고일자 to=20260101' \
  --data-urlencode '업체코드=11110' \
  --data-urlencode '인증키=값'

const params = new URLSearchParams({
  "serviceKey": "발급받은_인증키",
  "BL번호": "값",
  "수출입구분": "값",
  "신고일자 from": "20260101",
  "신고일자 to": "20260101",
  "업체코드": "11110",
  "인증키": "값",
});

const res = await fetch(`https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}?${params}`);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

import requests

params = {
    "serviceKey": "발급받은_인증키",
    "BL번호": "값",
    "수출입구분": "값",
    "신고일자 from": "20260101",
    "신고일자 to": "20260101",
    "업체코드": "11110",
    "인증키": "값",
}

r = requests.get("https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}", params=params, timeout=15)
r.raise_for_status()
print(r.json())