해양수산부_선박제원정보 서비스

이 데이터는 해양수산부에서 각 지방해양수산청별로 등록된 선박의 제반 사항을 제공하기 위해 수집한 데이터입니다.선박명, 호출부호 등 입력 파라미터를 통해 데이터를 호출하실 수 있으며, 본 데이터의 주요 내용은 선박명, 호출부호, 총톤수, 길이, 너비 등 선박 제원 정보로 구성되어 있습니다.본 데이터는 해운업체가 선박의 제원과 운항 형태를 분석하여 선박 운용 계획을 수립하는 데 활용될 수 있습니다. 또한 연구기관은 선박 제원 정보를 활용하여 해운 산업의 동향을 연구하고, 정부 및 관련 기관은 선박 등록 현황을 분석하여 해운 정책 수립 및 제도 개선을 위한 기초자료로 활용할 수 있습니다.

body header IMO번호 item items 국제총톤수 나용선구분 나용선구분명 내외항구분 데이터 총 개수 선박건조일시 선박국적 선박길이 선박깊이 선박너비 선박번호 선박영문명 선박종류 선박총길이 선박한글명 선박흘수 순톤수 신조선여부 운항형태명 운항형태코드 응답결과 메시지 응답결과 코드 이전호출부호 총톤수 톤수증서구분 톤수증서구분명 페이지 수 한 페이지 결과 수 호출부호

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

curl -G 'https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}' \
  --data-urlencode 'serviceKey=발급받은_인증키' \
  --data-urlencode '검색을 원하는 조회 호출부호=값' \
  --data-urlencode '검색하고자 하는 선박명=값' \
  --data-urlencode '공공데이터포털에서 받은 인증키=값' \
  --data-urlencode '조회 결과 데이터 최대 개수(최대 50)=값' \
  --data-urlencode '페이지번호=1'

const params = new URLSearchParams({
  "serviceKey": "발급받은_인증키",
  "검색을 원하는 조회 호출부호": "값",
  "검색하고자 하는 선박명": "값",
  "공공데이터포털에서 받은 인증키": "값",
  "조회 결과 데이터 최대 개수(최대 50)": "값",
  "페이지번호": "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": "발급받은_인증키",
    "검색을 원하는 조회 호출부호": "값",
    "검색하고자 하는 선박명": "값",
    "공공데이터포털에서 받은 인증키": "값",
    "조회 결과 데이터 최대 개수(최대 50)": "값",
    "페이지번호": "1",
}

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