| 분류체계 | 교통및물류 - 해운·항만 | 제공기관 | 해양수산부 |
|---|---|---|---|
| 관리부서명 | 항만운영과 | 관리부서 전화번호 | |
| API 유형 | REST | 데이터포맷 | XML |
| 활용신청 | 116 | 키워드 | 관제,본선동정,입출항 |
| 등록일 | 2018-07-23 | 수정일 | 2023-10-25 |
| 비용부과유무 | 무료 | 신청가능 트래픽 | 개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능 |
| 심의유형 | 개발단계 : 자동승인 / 운영단계 : 자동승인 | ||
| 이용허락범위 | |||
| 참고문서 | DAT211_오픈API활용가이드_관제정보.docx | ||
요청변수(Request Parameter)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 인증키 | serviceKey | 100 | 필수 | - | 공공데이터포털에서 받은 인증키 |
| 페이지 번호 | pageNo | 4 | 옵션 | 1 | 페이지번호 |
| 한 페이지 결과 수 | numOfRows | 4 | 옵션 | 10 | 조회 결과 데이터 최대 개수(최대 50) |
| 항만청코드 | prtAgCd | 3 | 필수 | 020 | 검색하고자 하는 항만청 코드 |
| 검색 시작일 | sde | 8 | 필수 | 20171227 | 검색을 원하는 조회 시작 날짜 |
| 검색 종료일 | ede | 9 | 필수 | 20171227 | 검색을 원하는 조회 종료 날짜 |
| 호출부호 | clsgn | 16 | 옵션 | 검색을 원하는 조회 호출부호 |
출력결과(Response Element)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 응답결과 코드 | resultCode | 2 | 필수 | 00 | 결과코드 |
| 응답결과 메시지 | resultMsg | 50 | 필수 | NORMAL_SERVICE | 결과메시지 |
| 한 페이지 결과 수 | numOfRows | 4 | 필수 | 2 | 한 페이지당 표출 데이터 |
| 페이지 수 | pageNo | 4 | 필수 | 2 | 페이지 수 |
| 데이터 총 개수 | totalCount | 40 | 필수 | 9 | 데이터 총 개수 |
| 항구청코드 | prtAgCd | 3 | 필수 | 020 | 항구청코드 |
| 항만명 | prtAgNm | 10 | 옵션 | 부산 | 항만명 |
| 입항년도 | etryptYear | 4 | 옵션 | 2017 | 입항년도 |
| 입항횟수 | etryptCo | 3 | 옵션 | 001 | 입항횟수 |
| 호출부호 | clsgn | 10 | 옵션 | ABCDE | 호출부호 |
| 선박종류코드 | vsslKndCd | 2 | 옵션 | 41 | 선박종류코드 |
| 선박종류명 | vsslKndNm | 10 | 옵션 | 풀컨테이너선 | 선박종류명 |
| 선박한글명 | vsslNm | 20 | 옵션 | AN HAI 261 | 선박한글명 |
| 선박총톤수 | vsslGrtg | 7 | 옵션 | 18872 | 선박총톤수 |
| 선박국적코드 | vsslNltyCd | 2 | 옵션 | SG | 선박국적코드 |
| 선박국적명 | vsslNltyNm | 10 | 옵션 | 싱가포르 | 선박국적명 |
| 선박신고청코드 | vsslSatmntAgCd | 3 | 옵션 | 020 | 선박신고청코드 |
| 신고입항년도 | satmntEtryptYear | 4 | 옵션 | 2017 | 신고입항년도 |
| 신고입항횟수 | satmntEtryptCo | 3 | 옵션 | 001 | 신고입항횟수 |
| 기항지입항일시 | aprtfEtryptDt | 25 | 옵션 | 2017-01-01T01:00:00+09:00 | 기항지입항일시 |
| 출항일시 | tkoffDt | 25 | 옵션 | 2017-01-01T08:50:00+09:00 | 출항일시 |
| 항만업체코드 | harborEntrpsCd | 10 | 옵션 | KMC0211 | 항만업체코드 |
| 항만업체명 | harborEntrpsNm | 30 | 옵션 | 만해항운한국(주) | 항만업체명 |
| 관제구분명 | cntrlNm | 2 | 옵션 | 입항 | 관제구분명 |
| 입항년도 | etryptYear | 4 | 옵션 | 2017 | 입항년도 |
| 입항횟수 | etryptCo | 3 | 옵션 | 001 | 입항횟수 |
| 통신횟수 | commCo | 3 | 옵션 | 001 | 통신횟수 |
| 관제구분 | cntrlSe | 2 | 옵션 | 03 | 관제구분 |
| 관제작업일시 | cntrlOpertDt | 25 | 옵션 | 2017-01-01T01:00:00+09:00 | 관제작업일시 |
| 시설코드 | fcltyCd | 3 | 옵션 | MBR | 시설코드 |
| 시설서브코드 | fcltySubCd | 2 | 옵션 | E1 | 시설서브코드 |
| 시설 한글명 | fcltyNm | 9 | 옵션 | 신감만부두 1선석 | 시설 한글명 |
샘플코드는 PC에서 확인해주세요.
| 분류체계 | 교통및물류 - 해운·항만 | |
|---|---|---|
| 제공기관 | 해양수산부 | |
| 관리부서명 | 항만운영과 | |
| 관리부서 전화번호 | ||
| API 유형 | REST | |
| 데이터포맷 | XML | |
| 활용신청 | 116 | |
| 키워드 | 관제,본선동정,입출항 | |
| 등록일 | 2018-07-23 | |
| 수정일 | 2023-10-25 | |
| 심의유형 | 개발단계 : 자동승인 / 운영단계 : 자동승인 | |
| 비용부과유무 | 무료 | |
| 신청가능 트래픽 | 개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능 | |
| 이용허락범위 | ||
| 참고문서 | DAT211_오픈API활용가이드_관제정보.docx | |
요청변수(Request Parameter)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 인증키 | serviceKey | 100 | 필수 | - | 공공데이터포털에서 받은 인증키 |
| 페이지 번호 | pageNo | 4 | 옵션 | 1 | 페이지번호 |
| 한 페이지 결과 수 | numOfRows | 4 | 옵션 | 10 | 조회 결과 데이터 최대 개수(최대 50) |
| 항만청코드 | prtAgCd | 3 | 필수 | 020 | 검색하고자 하는 항만청 코드 |
| 검색 시작일 | sde | 8 | 필수 | 20171227 | 검색을 원하는 조회 시작 날짜 |
| 검색 종료일 | ede | 9 | 필수 | 20171227 | 검색을 원하는 조회 종료 날짜 |
| 호출부호 | clsgn | 16 | 옵션 | 검색을 원하는 조회 호출부호 |
출력결과(Response Element)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 응답결과 코드 | resultCode | 2 | 필수 | 00 | 결과코드 |
| 응답결과 메시지 | resultMsg | 50 | 필수 | NORMAL_SERVICE | 결과메시지 |
| 한 페이지 결과 수 | numOfRows | 4 | 필수 | 2 | 한 페이지당 표출 데이터 |
| 페이지 수 | pageNo | 4 | 필수 | 2 | 페이지 수 |
| 데이터 총 개수 | totalCount | 40 | 필수 | 9 | 데이터 총 개수 |
| 항구청코드 | prtAgCd | 3 | 필수 | 020 | 항구청코드 |
| 항만명 | prtAgNm | 10 | 옵션 | 부산 | 항만명 |
| 입항년도 | etryptYear | 4 | 옵션 | 2017 | 입항년도 |
| 입항횟수 | etryptCo | 3 | 옵션 | 001 | 입항횟수 |
| 호출부호 | clsgn | 10 | 옵션 | ABCDE | 호출부호 |
| 선박종류코드 | vsslKndCd | 2 | 옵션 | 41 | 선박종류코드 |
| 선박종류명 | vsslKndNm | 10 | 옵션 | 풀컨테이너선 | 선박종류명 |
| 선박한글명 | vsslNm | 20 | 옵션 | AN HAI 261 | 선박한글명 |
| 선박총톤수 | vsslGrtg | 7 | 옵션 | 18872 | 선박총톤수 |
| 선박국적코드 | vsslNltyCd | 2 | 옵션 | SG | 선박국적코드 |
| 선박국적명 | vsslNltyNm | 10 | 옵션 | 싱가포르 | 선박국적명 |
| 선박신고청코드 | vsslSatmntAgCd | 3 | 옵션 | 020 | 선박신고청코드 |
| 신고입항년도 | satmntEtryptYear | 4 | 옵션 | 2017 | 신고입항년도 |
| 신고입항횟수 | satmntEtryptCo | 3 | 옵션 | 001 | 신고입항횟수 |
| 기항지입항일시 | aprtfEtryptDt | 25 | 옵션 | 2017-01-01T01:00:00+09:00 | 기항지입항일시 |
| 출항일시 | tkoffDt | 25 | 옵션 | 2017-01-01T08:50:00+09:00 | 출항일시 |
| 항만업체코드 | harborEntrpsCd | 10 | 옵션 | KMC0211 | 항만업체코드 |
| 항만업체명 | harborEntrpsNm | 30 | 옵션 | 만해항운한국(주) | 항만업체명 |
| 관제구분명 | cntrlNm | 2 | 옵션 | 입항 | 관제구분명 |
| 입항년도 | etryptYear | 4 | 옵션 | 2017 | 입항년도 |
| 입항횟수 | etryptCo | 3 | 옵션 | 001 | 입항횟수 |
| 통신횟수 | commCo | 3 | 옵션 | 001 | 통신횟수 |
| 관제구분 | cntrlSe | 2 | 옵션 | 03 | 관제구분 |
| 관제작업일시 | cntrlOpertDt | 25 | 옵션 | 2017-01-01T01:00:00+09:00 | 관제작업일시 |
| 시설코드 | fcltyCd | 3 | 옵션 | MBR | 시설코드 |
| 시설서브코드 | fcltySubCd | 2 | 옵션 | E1 | 시설서브코드 |
| 시설 한글명 | fcltyNm | 9 | 옵션 | 신감만부두 1선석 | 시설 한글명 |
샘플코드는 PC에서 확인해주세요.