인천항만공사_인천항여객터미널 이용 국내외 선박정보 조회 서비스

해당 오픈 데이터는 인천항 여객 터미널의 국내선 이용 선박 정보를 조회할 수 있는 Open API로 API는 REST 방식으로 작동하며 XML 포맷으로 제공됩니다. 호출 시 선박 ID, 선박명, 운항정보, 출항시간, 정박지, 운임정보, 선사명, 터미널 코드 등 다양한 선박 운영 관련 정보가 반환됩니다. 주요 입력 파라미터는 인증키, 선박명, 선박ID 등이 있으며, 호출 결과로는 선박 개요, 선석 위치, 승선 요금, 최종 운항일, 터미널 위치 등을 확인할 수 있습니다. 이 API는 여객선 운항 정보 제공, 여객 안내 시스템 연동, 선사 운영정보 분석, 항로별 수요 예측 등 다양한 항만 운영 및 고객 서비스 개선에 활용 가능합니다.

body header item items 결과메세지 결과코드 국제입출항정보아이디 데이터 총 개수 등급 등록_일시 비고 선명 선박아이디 선사명 선사소개 소요_분 소요_시 소요_일 수정_일시 영문 영문_등급 영문_선명 영문_선사명 영문_선사소개 영문_운임 요일 운임 운항상태 전화번호 중문 중문_등급 중문_선명 중문_선사명 중문_선사소개 중문_운임 출발/도착_분 출발/도착_시 출발지/도착지코드 출항/입항 탑승수속_분 탑승수속_시 터미널_코드 페이지 수 한 페이지당 표출 데이터 수 호출부호 홈페이지 활성여부

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

curl -G 'https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}' \
  --data-urlencode 'serviceKey=발급받은_인증키' \
  --data-urlencode '인증키=값' \
  --data-urlencode '조회 선박명=값' \
  --data-urlencode '조회 선사명=값' \
  --data-urlencode '조회 요일=값' \
  --data-urlencode '조회 입출항구분(1:입항=값' \
  --data-urlencode '2:출항)=값'

const params = new URLSearchParams({
  "serviceKey": "발급받은_인증키",
  "인증키": "값",
  "조회 선박명": "값",
  "조회 선사명": "값",
  "조회 요일": "값",
  "조회 입출항구분(1:입항": "값",
  "2:출항)": "값",
});

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:입항": "값",
    "2:출항)": "값",
}

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