인천항만공사_인천항 선박 제원 정보 조회 서비스

해당 데이터는 호출부호와 선박명을 기준으로 인천항에 입항하는 선박의 제원 상세 정보를 Open API 형태로 제공합니다. 요청 변수에는 callLetter(호출부호), vsslKorNm(선박명) 등이 있으며, 응답 결과에 따라 선박 번호(vsslNo), 한글 및 영문 선박명(vsslKorNm, vsslEngNm), 국적코드(flag, flagNm), 선박의 총톤수(grsTn), 규칙톤수(intTn), 순톤수(netTn), 선박 제원(크기, 너비, 길이, 깊이, 흘수, 용적) 등의 데이터가 포함되며 항만운영시스템(POS), 해양안전관리, 선박 입출항 계획 수립, 항만시설 운영 최적화 등 다양한 분야에서 활용되며, 실시간 선박 특성 분석 및 선박 관련 통계 구축에도 유용한 자료로 활용됩니다.

body header item items 결과메세지 결과코드 국제 총톤수 내외항구분 내외항구분명 내외항구분명(한글명) 데이터 총 개수 사용여부 선박 길이 선박 깊이 선박 너비 선박 번호 선박 종류 선박 총길이 선박 흘수 선박국적명 선박국적코드 선박명(영문명) 선박명(한글명) 선박종류명 순 톤수 업체명 업체코드 전호출부호 총 톤 수 페이지 수 한 페이지당 표출 데이터 수 호출부호

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

curl -G 'https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}' \
  --data-urlencode 'serviceKey=발급받은_인증키' \
  --data-urlencode '선박명(한글명)=값' \
  --data-urlencode '인증키=값' \
  --data-urlencode '줄수=값' \
  --data-urlencode '페이지번호=1' \
  --data-urlencode '호출부호=값'

const params = new URLSearchParams({
  "serviceKey": "발급받은_인증키",
  "선박명(한글명)": "값",
  "인증키": "값",
  "줄수": "값",
  "페이지번호": "1",
  "호출부호": "값",
});

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": "발급받은_인증키",
    "선박명(한글명)": "값",
    "인증키": "값",
    "줄수": "값",
    "페이지번호": "1",
    "호출부호": "값",
}

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