| 분류체계 | 교통및물류 - 해운·항만 | 제공기관 | 해양수산부 |
|---|---|---|---|
| 관리부서명 | 항만운영과 | 관리부서 전화번호 | |
| API 유형 | REST | 데이터포맷 | XML |
| 활용신청 | 65 | 키워드 | 화물반출입,화물반입,화물반출 |
| 등록일 | 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 | 필수 | 001 | 검색을 원하는 선박의 입항횟수 |
| 호출부호 | clsgn | 16 | 필수 | DDYL2 | 검색을 원하는 조회 호출부호 |
출력결과(Response Element)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 응답결과 코드 | resultCode | 2 | 필수 | 00 | 응답결과 코드 |
| 응답결과 메시지 | resultMsg | 50 | 필수 | NORMAL_SERVICE | 응답결과 메시지 |
| 한 페이지 결과 수 | numOfRows | 4 | 필수 | 10 | 한 페이지당 표출 데이터 수 |
| 페이지 수 | pageNo | 4 | 필수 | 1 | 페이지 수 |
| 데이터 총 개수 | totalCount | 40 | 필수 | 2 | 데이터 총 개수 |
| 항구청코드 | prtAgCd | 3 | 필수 | 020 | 항구청코드 |
| 항구청명 | prtAgNm | 10 | 옵션 | 부산 | 항구청명 |
| 입항년도 | etryptYear | 4 | 필수 | 2017 | 입항년도 |
| 입항횟수 | etryptCo | 3 | 필수 | 001 | 입항횟수 |
| 입출항일시 | etryndDt | 25 | 옵션 | 2017-01-01T18:00:00+09:00 | 입출항일시 |
| 호출부호 | clsgn | 10 | 필수 | DDYL2 | 호출부호 |
| 선박한글명 | vsslNm | 20 | 옵션 | 찡타오 익스프레스 | 선박한글명 |
| 선박종류코드 | vsslKndCd | 2 | 옵션 | 41 | 선박종류코드 |
| 선박종류명 | vsslKndNm | 8 | 옵션 | 풀컨테이너선 | 선박종류명 |
| 반입반출구분 | tkinTkoutSe | 2 | 옵션 | OT | 반입반출구분 |
| 반입반출구분명 | tkinTkoutNm | 2 | 옵션 | 수출환적 | 반입반출구분명 |
| 계선장소코드 | laidupPlaceCd | 3 | 옵션 | MS4 | 계선장소코드 |
| 계선장소서브코드 | laidupPlaceSubCd | 2 | 옵션 | 02 | 계선장소서브코드 |
| 계선장소명 | laidupFcltyNm | 20 | 옵션 | 신항 4부두 2선석 | 계선장소명 |
| 화물품목코드 | frghtPrdlstCd | 6 | 옵션 | 870899 | 화물품목코드 |
| 화물품목명 | frghtPrdlstKorNm | 100 | 옵션 | 부분품과 부속품(제8701호부터 제8705호까지의 차량용으로 한정한다)(그 밖의 부분품과 부속품,기타) | 화물품목명 |
| 화물품목영문명 | frghtPrdlstEngNm | 100 | 옵션 | Parts and accessories of the motor vehicles of headings 87.01 to 87.05.(Other parts and accessories,Other) | 화물품목영문명 |
| 위험물적재유무 | dgstLdadngYn | 1 | 옵션 | 2 | 위험물적재유무 |
| 화물분류코드 | frghtClCd | 2 | 옵션 | 30 | 화물분류코드 |
| 국내지역통계분류코드 | dmstcAreaStatsClCd | 2 | 옵션 | 57 | 국내지역통계분류코드 |
| 양적하항구코드 | lduldPrtCd | 5 | 옵션 | KRKAN | 양적하항구코드 |
| 양적하항구명 | lduldPrtNm | 2 | 옵션 | 광양 | 양적하항구명 |
| 용적톤수 | msrmnTon | 4 | 옵션 | 1 | 용적톤수 |
| 용적단위구분 | msrmntUnitSe | 1 | 옵션 | M | 용적단위구분 |
| 용적단위구분명 | msrmntUnitNm | 3 | 옵션 | 6Q8 | 용적단위구분명 |
| 중량톤 | wtTon | 3 | 옵션 | 67775 | 중량톤 |
| 신고일시 | satmntDt | 25 | 옵션 | 2017-02-13T16:18:00+09:00 | 신고일시 |
| 포장종류코드 | packngKndCd | 3 | 옵션 | CNT | 포장종류코드 |
| 포장종류명 | packngKndNm | 10 | 옵션 | 컨테이너 | 포장종류명 |
| 운임톤 | cychgTon | 4 | 옵션 | 67775 | 운임톤 |
| 하역방법코드 | lnlMthCd | 1 | 옵션 | 2 | 하역방법코드 |
| 하역방법명 | lnlMthNm | 5 | 옵션 | 기계하역 | 하역방법명 |
| 기항지입항일시 | aprtfEtryptDt | 25 | 옵션 | 2017-01-01T18:00:00+09:00 | 기항지입항일시 |
| 하역업체코드 | lnlEntrpsCd | 10 | 옵션 | BSG0014 | 하역업체코드 |
| 하역업체명 | lnlEntrpsNm | 30 | 옵션 | 부산콘테이너부두운영 | 하역업체명 |
샘플코드는 PC에서 확인해주세요.
| 분류체계 | 교통및물류 - 해운·항만 | |
|---|---|---|
| 제공기관 | 해양수산부 | |
| 관리부서명 | 항만운영과 | |
| 관리부서 전화번호 | ||
| API 유형 | REST | |
| 데이터포맷 | XML | |
| 활용신청 | 65 | |
| 키워드 | 화물반출입,화물반입,화물반출 | |
| 등록일 | 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 | 필수 | 001 | 검색을 원하는 선박의 입항횟수 |
| 호출부호 | clsgn | 16 | 필수 | DDYL2 | 검색을 원하는 조회 호출부호 |
출력결과(Response Element)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 응답결과 코드 | resultCode | 2 | 필수 | 00 | 응답결과 코드 |
| 응답결과 메시지 | resultMsg | 50 | 필수 | NORMAL_SERVICE | 응답결과 메시지 |
| 한 페이지 결과 수 | numOfRows | 4 | 필수 | 10 | 한 페이지당 표출 데이터 수 |
| 페이지 수 | pageNo | 4 | 필수 | 1 | 페이지 수 |
| 데이터 총 개수 | totalCount | 40 | 필수 | 2 | 데이터 총 개수 |
| 항구청코드 | prtAgCd | 3 | 필수 | 020 | 항구청코드 |
| 항구청명 | prtAgNm | 10 | 옵션 | 부산 | 항구청명 |
| 입항년도 | etryptYear | 4 | 필수 | 2017 | 입항년도 |
| 입항횟수 | etryptCo | 3 | 필수 | 001 | 입항횟수 |
| 입출항일시 | etryndDt | 25 | 옵션 | 2017-01-01T18:00:00+09:00 | 입출항일시 |
| 호출부호 | clsgn | 10 | 필수 | DDYL2 | 호출부호 |
| 선박한글명 | vsslNm | 20 | 옵션 | 찡타오 익스프레스 | 선박한글명 |
| 선박종류코드 | vsslKndCd | 2 | 옵션 | 41 | 선박종류코드 |
| 선박종류명 | vsslKndNm | 8 | 옵션 | 풀컨테이너선 | 선박종류명 |
| 반입반출구분 | tkinTkoutSe | 2 | 옵션 | OT | 반입반출구분 |
| 반입반출구분명 | tkinTkoutNm | 2 | 옵션 | 수출환적 | 반입반출구분명 |
| 계선장소코드 | laidupPlaceCd | 3 | 옵션 | MS4 | 계선장소코드 |
| 계선장소서브코드 | laidupPlaceSubCd | 2 | 옵션 | 02 | 계선장소서브코드 |
| 계선장소명 | laidupFcltyNm | 20 | 옵션 | 신항 4부두 2선석 | 계선장소명 |
| 화물품목코드 | frghtPrdlstCd | 6 | 옵션 | 870899 | 화물품목코드 |
| 화물품목명 | frghtPrdlstKorNm | 100 | 옵션 | 부분품과 부속품(제8701호부터 제8705호까지의 차량용으로 한정한다)(그 밖의 부분품과 부속품,기타) | 화물품목명 |
| 화물품목영문명 | frghtPrdlstEngNm | 100 | 옵션 | Parts and accessories of the motor vehicles of headings 87.01 to 87.05.(Other parts and accessories,Other) | 화물품목영문명 |
| 위험물적재유무 | dgstLdadngYn | 1 | 옵션 | 2 | 위험물적재유무 |
| 화물분류코드 | frghtClCd | 2 | 옵션 | 30 | 화물분류코드 |
| 국내지역통계분류코드 | dmstcAreaStatsClCd | 2 | 옵션 | 57 | 국내지역통계분류코드 |
| 양적하항구코드 | lduldPrtCd | 5 | 옵션 | KRKAN | 양적하항구코드 |
| 양적하항구명 | lduldPrtNm | 2 | 옵션 | 광양 | 양적하항구명 |
| 용적톤수 | msrmnTon | 4 | 옵션 | 1 | 용적톤수 |
| 용적단위구분 | msrmntUnitSe | 1 | 옵션 | M | 용적단위구분 |
| 용적단위구분명 | msrmntUnitNm | 3 | 옵션 | 6Q8 | 용적단위구분명 |
| 중량톤 | wtTon | 3 | 옵션 | 67775 | 중량톤 |
| 신고일시 | satmntDt | 25 | 옵션 | 2017-02-13T16:18:00+09:00 | 신고일시 |
| 포장종류코드 | packngKndCd | 3 | 옵션 | CNT | 포장종류코드 |
| 포장종류명 | packngKndNm | 10 | 옵션 | 컨테이너 | 포장종류명 |
| 운임톤 | cychgTon | 4 | 옵션 | 67775 | 운임톤 |
| 하역방법코드 | lnlMthCd | 1 | 옵션 | 2 | 하역방법코드 |
| 하역방법명 | lnlMthNm | 5 | 옵션 | 기계하역 | 하역방법명 |
| 기항지입항일시 | aprtfEtryptDt | 25 | 옵션 | 2017-01-01T18:00:00+09:00 | 기항지입항일시 |
| 하역업체코드 | lnlEntrpsCd | 10 | 옵션 | BSG0014 | 하역업체코드 |
| 하역업체명 | lnlEntrpsNm | 30 | 옵션 | 부산콘테이너부두운영 | 하역업체명 |
샘플코드는 PC에서 확인해주세요.