| 분류체계 | 교통및물류 - 해운·항만 | 제공기관 | 해양수산부 |
|---|---|---|---|
| 관리부서명 | 항만운영과 | 관리부서 전화번호 | |
| API 유형 | REST | 데이터포맷 | XML |
| 활용신청 | 83 | 키워드 | 항만시설사용,정박지,선석 |
| 등록일 | 2018-09-05 | 수정일 | 2023-10-25 |
| 비용부과유무 | 무료 | 신청가능 트래픽 | 개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능 |
| 심의유형 | 개발단계 : 자동승인 / 운영단계 : 자동승인 | ||
| 이용허락범위 | |||
| 참고문서 | DAT211_오픈API활용가이드_항만시설사용신고정보.docx | ||
요청변수(Request Parameter)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 인증키 | serviceKey | 100 | 필수 | - | 공공데이터포털에서 받은 인증키 |
| 페이지 번호 | pageNo | 4 | 옵션 | 1 | 페이지번호 |
| 한 페이지 결과 수 | numOfRows | 4 | 옵션 | 10 | 조회 결과 데이터 최대 개수(최대 50) |
| 항만청코드 | prtAgCd | 3 | 필수 | 020 | 검색하고자 하는 항만청 코드 |
| 입항연도 | etryptYear | 4 | 필수 | 2017 | 검색을 원하는 선박의 입항연도 |
| 입항횟수 | etryptCo | 3 | 필수 | 006 | 검색을 원하는 선박의 입항횟수 |
| 호출부호 | clsgn | 16 | 필수 | A8OR9 | 검색을 원하는 조회 호출부호 |
출력결과(Response Element)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 응답결과 코드 | resultCode | 2 | 필수 | 00 | 응답결과 코드 |
| 응답결과 메시지 | resultMsg | 50 | 필수 | NORMAL_SERVICE | 응답결과 메시지 |
| 한 페이지 결과 수 | numOfRows | 2 | 필수 | 2 | 한 페이지 결과 수 |
| 페이지 수 | pageNo | 2 | 필수 | 1 | 페이지 수 |
| 데이터 총 개수 | totalCount | 40 | 필수 | 9 | 데이터 총 개수 |
| 항구청코드 | prtAgCd | 3 | 필수 | 020 | 항구청코드 |
| 항만명 | prtAgNm | 2 | 옵션 | 부산 | 항만명 |
| 입항년도 | etryptYear | 4 | 필수 | 2017 | 입항년도 |
| 입항횟수 | etryptCo | 3 | 필수 | 006 | 입항횟수 |
| 호출부호 | clsgn | 10 | 필수 | A8OR9 | 호출부호 |
| 요금종류명 | chrgeKndNm | 3 | 옵션 | 화물료 | 요금종류명 |
| 선박종류코드 | vsslKndCd | 2 | 옵션 | 41 | 선박종류코드 |
| 선박한글명 | vsslNm | 11 | 옵션 | YM EMINENCE | 선박한글명 |
| 사용구분 | useSe | 1 | 옵션 | 1 | 사용구분 |
| 사용구분명 | useSeNm | 4 | 옵션 | 외항입항 | 사용구분명 |
| 업체명 | entrpsCdNm | 30 | 옵션 | 페스코라인즈코이라(주) | 업체명 |
| 통합화물정정차수 | unityFrghtUpdtOdr | 5 | 옵션 | 1 | 통합화물정정차수 |
| 회계년도 | accnutYear | 4 | 옵션 | 2017 | 회계년도 |
| 고지번호 | nticNo | 6 | 옵션 | 033028 | 고지번호 |
| 계선장소코드 | laidupPlaceCd | 3 | 옵션 | MSN | 계선장소코드 |
| 계선장소서브코드 | laidupPlaceSubCd | 2 | 옵션 | 07 | 계선장소서브코드 |
| 계선장소명 | laidupFcltyNm | 20 | 옵션 | 신항 2부두 4선석 | 계선장소명 |
| 입출항일시 | etryndDt | 21 | 옵션 | 2017-08-03 14:00:00.0 | 입출항일시 |
| 신고일시 | satmntDt | 21 | 옵션 | 2017-08-07 10:12:38.0 | 신고일시 |
| 납기일시 | dedtDt | 21 | 옵션 | 2017-08-18 00:00:00.0 | 납기일시 |
| 총사용료 | totRntfee | 10 | 옵션 | 0 | 총사용료 |
| 기항지입항일시 | aprtfEtryptDt | 21 | 옵션 | 2017-08-18 00:00:00.0 | 기항지입항일시 |
| 관리회수구분 | manageRtrvlSe | 3 | 옵션 | 002 | 관리회수구분 |
| 통합화물정정차수 | unityFrghtUpdtOdr | 5 | 옵션 | 1 | 통합화물정정차수 |
| 하역구분 | lnlSe | 2 | 옵션 | 8 | 하역구분 |
| 하역구분명 | lnlNm | 20 | 옵션 | 40 Feet Con | 하역구분명 |
| 운임톤 | cychgTon | 1 | 옵션 | 1 | 운임톤 |
| 기본요금 | bassChrge | 10 | 옵션 | 0 | 기본요금 |
| 기항지입항일시 | aprtfEtryptDt | 21 | 옵션 | 2017-08-18 00:00:00.0 | 기항지입항일시 |
| 할인율 | dscntRt | 20 | 옵션 | 0 | 할인율 |
샘플코드는 PC에서 확인해주세요.
| 분류체계 | 교통및물류 - 해운·항만 | |
|---|---|---|
| 제공기관 | 해양수산부 | |
| 관리부서명 | 항만운영과 | |
| 관리부서 전화번호 | ||
| API 유형 | REST | |
| 데이터포맷 | XML | |
| 활용신청 | 83 | |
| 키워드 | 항만시설사용,정박지,선석 | |
| 등록일 | 2018-09-05 | |
| 수정일 | 2023-10-25 | |
| 심의유형 | 개발단계 : 자동승인 / 운영단계 : 자동승인 | |
| 비용부과유무 | 무료 | |
| 신청가능 트래픽 | 개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능 | |
| 이용허락범위 | ||
| 참고문서 | DAT211_오픈API활용가이드_항만시설사용신고정보.docx | |
요청변수(Request Parameter)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 인증키 | serviceKey | 100 | 필수 | - | 공공데이터포털에서 받은 인증키 |
| 페이지 번호 | pageNo | 4 | 옵션 | 1 | 페이지번호 |
| 한 페이지 결과 수 | numOfRows | 4 | 옵션 | 10 | 조회 결과 데이터 최대 개수(최대 50) |
| 항만청코드 | prtAgCd | 3 | 필수 | 020 | 검색하고자 하는 항만청 코드 |
| 입항연도 | etryptYear | 4 | 필수 | 2017 | 검색을 원하는 선박의 입항연도 |
| 입항횟수 | etryptCo | 3 | 필수 | 006 | 검색을 원하는 선박의 입항횟수 |
| 호출부호 | clsgn | 16 | 필수 | A8OR9 | 검색을 원하는 조회 호출부호 |
출력결과(Response Element)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 응답결과 코드 | resultCode | 2 | 필수 | 00 | 응답결과 코드 |
| 응답결과 메시지 | resultMsg | 50 | 필수 | NORMAL_SERVICE | 응답결과 메시지 |
| 한 페이지 결과 수 | numOfRows | 2 | 필수 | 2 | 한 페이지 결과 수 |
| 페이지 수 | pageNo | 2 | 필수 | 1 | 페이지 수 |
| 데이터 총 개수 | totalCount | 40 | 필수 | 9 | 데이터 총 개수 |
| 항구청코드 | prtAgCd | 3 | 필수 | 020 | 항구청코드 |
| 항만명 | prtAgNm | 2 | 옵션 | 부산 | 항만명 |
| 입항년도 | etryptYear | 4 | 필수 | 2017 | 입항년도 |
| 입항횟수 | etryptCo | 3 | 필수 | 006 | 입항횟수 |
| 호출부호 | clsgn | 10 | 필수 | A8OR9 | 호출부호 |
| 요금종류명 | chrgeKndNm | 3 | 옵션 | 화물료 | 요금종류명 |
| 선박종류코드 | vsslKndCd | 2 | 옵션 | 41 | 선박종류코드 |
| 선박한글명 | vsslNm | 11 | 옵션 | YM EMINENCE | 선박한글명 |
| 사용구분 | useSe | 1 | 옵션 | 1 | 사용구분 |
| 사용구분명 | useSeNm | 4 | 옵션 | 외항입항 | 사용구분명 |
| 업체명 | entrpsCdNm | 30 | 옵션 | 페스코라인즈코이라(주) | 업체명 |
| 통합화물정정차수 | unityFrghtUpdtOdr | 5 | 옵션 | 1 | 통합화물정정차수 |
| 회계년도 | accnutYear | 4 | 옵션 | 2017 | 회계년도 |
| 고지번호 | nticNo | 6 | 옵션 | 033028 | 고지번호 |
| 계선장소코드 | laidupPlaceCd | 3 | 옵션 | MSN | 계선장소코드 |
| 계선장소서브코드 | laidupPlaceSubCd | 2 | 옵션 | 07 | 계선장소서브코드 |
| 계선장소명 | laidupFcltyNm | 20 | 옵션 | 신항 2부두 4선석 | 계선장소명 |
| 입출항일시 | etryndDt | 21 | 옵션 | 2017-08-03 14:00:00.0 | 입출항일시 |
| 신고일시 | satmntDt | 21 | 옵션 | 2017-08-07 10:12:38.0 | 신고일시 |
| 납기일시 | dedtDt | 21 | 옵션 | 2017-08-18 00:00:00.0 | 납기일시 |
| 총사용료 | totRntfee | 10 | 옵션 | 0 | 총사용료 |
| 기항지입항일시 | aprtfEtryptDt | 21 | 옵션 | 2017-08-18 00:00:00.0 | 기항지입항일시 |
| 관리회수구분 | manageRtrvlSe | 3 | 옵션 | 002 | 관리회수구분 |
| 통합화물정정차수 | unityFrghtUpdtOdr | 5 | 옵션 | 1 | 통합화물정정차수 |
| 하역구분 | lnlSe | 2 | 옵션 | 8 | 하역구분 |
| 하역구분명 | lnlNm | 20 | 옵션 | 40 Feet Con | 하역구분명 |
| 운임톤 | cychgTon | 1 | 옵션 | 1 | 운임톤 |
| 기본요금 | bassChrge | 10 | 옵션 | 0 | 기본요금 |
| 기항지입항일시 | aprtfEtryptDt | 21 | 옵션 | 2017-08-18 00:00:00.0 | 기항지입항일시 |
| 할인율 | dscntRt | 20 | 옵션 | 0 | 할인율 |
샘플코드는 PC에서 확인해주세요.