| 분류체계 | 교통및물류 - 해운·항만 | 제공기관 | 해양수산부 |
|---|---|---|---|
| 관리부서명 | 항만운영과 | 관리부서 전화번호 | |
| API 유형 | REST | 데이터포맷 | XML |
| 활용신청 | 55 | 키워드 | 컨테이너반출입,컨테이너반입,컨테이너반출 |
| 등록일 | 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 | 필수 | 003 | 검색을 원하는 선박의 입항횟수 |
| 호출부호 | clsgn | 16 | 필수 | D8BG | 검색을 원하는 조회 호출부호 |
출력결과(Response Element)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 응답결과 코드 | resultCode | 2 | 필수 | 00 | 응답결과 코드 |
| 응답결과 메시지 | resultMsg | 50 | 필수 | NORMAL_SERVICE | 응답결과 메시지 |
| 한 페이지 결과 수 | numOfRows | 4 | 필수 | 10 | 한 페이지 결과 수 |
| 페이지 수 | pageNo | 4 | 필수 | 1 | 페이지 수 |
| 데이터 총 개수 | totalCount | 40 | 필수 | 3 | 데이터 총 개수 |
| 항구청코드 | prtAgCd | 3 | 필수 | 020 | 항구청코드 |
| 항구청명 | prtAgNm | 10 | 옵션 | 부산 | 항구청명 |
| 입항년도 | etryptYear | 4 | 필수 | 2017 | 입항년도 |
| 입항횟수 | etryptCo | 3 | 필수 | 003 | 입항횟수 |
| 입출항일시 | etryndDt | 25 | 옵션 | 2017-02-02T03:00:00+09:00 | 입출항일시 |
| 호출부호 | clsgn | 10 | 옵션 | D8BG | 호출부호 |
| 선박한글명 | vsslNm | 15 | 옵션 | KHARIS HERITAGE | 선박한글명 |
| 선박종류코드 | vsslKndCd | 2 | 옵션 | 41 | 선박종류코드 |
| 선박종류명 | vsslKndNm | 10 | 옵션 | 풀컨테이너선 | 선박종류명 |
| 반입반출구분 | tkinTkoutSe | 2 | 옵션 | OT | 반입반출구분 |
| 반입반출구분명 | tkinTkoutNm | 4 | 옵션 | 수출환적 | 반입반출구분명 |
| 계선장소코드 | laidupPlaceCd | 3 | 옵션 | MBS | 계선장소코드 |
| 계선장소서브코드 | laidupPlaceSubCd | 2 | 옵션 | 1 | 계선장소서브코드 |
| 계선장소명 | laidupFcltyNm | 20 | 옵션 | 신선대부두 1선석 | 계선장소명 |
| 계-적+공 | contnTotal | 8 | 옵션 | 67 | 계-적+공 |
| 계-TEU | teuTotal | 8 | 옵션 | 90 | 계-TEU |
| 공-45 | econtn45Ft | 8 | 옵션 | 0 | 공-45 |
| 공-40 | econtn40Ft | 8 | 옵션 | 0 | 공-40 |
| 공-35 | econtn35Ft | 8 | 옵션 | 0 | 공-35 |
| 공-20 | econtn20Ft | 8 | 옵션 | 0 | 공-20 |
| 공-10 | econtn10Ft | 8 | 옵션 | 0 | 공-10 |
| 공-기타 | econtnEtc | 8 | 옵션 | 0 | 공-기타 |
| 적-45 | fcontn45Ft | 8 | 옵션 | 0 | 적-45 |
| 적-40 | fcontn40Ft | 8 | 옵션 | 23 | 적-40 |
| 적-35 | fcontn35Ft | 8 | 옵션 | 0 | 적-35 |
| 적-20 | fcontn20Ft | 8 | 옵션 | 44 | 적-20 |
| 적-10 | fcontn10Ft | 8 | 옵션 | 0 | 적-10 |
| 적-기타 | fcontnEtc | 8 | 옵션 | 0 | 적-기타 |
샘플코드는 PC에서 확인해주세요.
| 분류체계 | 교통및물류 - 해운·항만 | |
|---|---|---|
| 제공기관 | 해양수산부 | |
| 관리부서명 | 항만운영과 | |
| 관리부서 전화번호 | ||
| API 유형 | REST | |
| 데이터포맷 | XML | |
| 활용신청 | 55 | |
| 키워드 | 컨테이너반출입,컨테이너반입,컨테이너반출 | |
| 등록일 | 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 | 필수 | 003 | 검색을 원하는 선박의 입항횟수 |
| 호출부호 | clsgn | 16 | 필수 | D8BG | 검색을 원하는 조회 호출부호 |
출력결과(Response Element)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 응답결과 코드 | resultCode | 2 | 필수 | 00 | 응답결과 코드 |
| 응답결과 메시지 | resultMsg | 50 | 필수 | NORMAL_SERVICE | 응답결과 메시지 |
| 한 페이지 결과 수 | numOfRows | 4 | 필수 | 10 | 한 페이지 결과 수 |
| 페이지 수 | pageNo | 4 | 필수 | 1 | 페이지 수 |
| 데이터 총 개수 | totalCount | 40 | 필수 | 3 | 데이터 총 개수 |
| 항구청코드 | prtAgCd | 3 | 필수 | 020 | 항구청코드 |
| 항구청명 | prtAgNm | 10 | 옵션 | 부산 | 항구청명 |
| 입항년도 | etryptYear | 4 | 필수 | 2017 | 입항년도 |
| 입항횟수 | etryptCo | 3 | 필수 | 003 | 입항횟수 |
| 입출항일시 | etryndDt | 25 | 옵션 | 2017-02-02T03:00:00+09:00 | 입출항일시 |
| 호출부호 | clsgn | 10 | 옵션 | D8BG | 호출부호 |
| 선박한글명 | vsslNm | 15 | 옵션 | KHARIS HERITAGE | 선박한글명 |
| 선박종류코드 | vsslKndCd | 2 | 옵션 | 41 | 선박종류코드 |
| 선박종류명 | vsslKndNm | 10 | 옵션 | 풀컨테이너선 | 선박종류명 |
| 반입반출구분 | tkinTkoutSe | 2 | 옵션 | OT | 반입반출구분 |
| 반입반출구분명 | tkinTkoutNm | 4 | 옵션 | 수출환적 | 반입반출구분명 |
| 계선장소코드 | laidupPlaceCd | 3 | 옵션 | MBS | 계선장소코드 |
| 계선장소서브코드 | laidupPlaceSubCd | 2 | 옵션 | 1 | 계선장소서브코드 |
| 계선장소명 | laidupFcltyNm | 20 | 옵션 | 신선대부두 1선석 | 계선장소명 |
| 계-적+공 | contnTotal | 8 | 옵션 | 67 | 계-적+공 |
| 계-TEU | teuTotal | 8 | 옵션 | 90 | 계-TEU |
| 공-45 | econtn45Ft | 8 | 옵션 | 0 | 공-45 |
| 공-40 | econtn40Ft | 8 | 옵션 | 0 | 공-40 |
| 공-35 | econtn35Ft | 8 | 옵션 | 0 | 공-35 |
| 공-20 | econtn20Ft | 8 | 옵션 | 0 | 공-20 |
| 공-10 | econtn10Ft | 8 | 옵션 | 0 | 공-10 |
| 공-기타 | econtnEtc | 8 | 옵션 | 0 | 공-기타 |
| 적-45 | fcontn45Ft | 8 | 옵션 | 0 | 적-45 |
| 적-40 | fcontn40Ft | 8 | 옵션 | 23 | 적-40 |
| 적-35 | fcontn35Ft | 8 | 옵션 | 0 | 적-35 |
| 적-20 | fcontn20Ft | 8 | 옵션 | 44 | 적-20 |
| 적-10 | fcontn10Ft | 8 | 옵션 | 0 | 적-10 |
| 적-기타 | fcontnEtc | 8 | 옵션 | 0 | 적-기타 |
샘플코드는 PC에서 확인해주세요.