이 API는 **SeaVantage 내부 Port ID(portId)**를 이용하여
특정 항구의 상세 정보를 조회할 수 있는 기능을 제공합니다.
요청 방식
•
HTTP Method : GET
•
API 경로 : /port/{portId}
•
인증 방식 : Basic Auth
•
응답 포맷 : JSON
인증 방법
Swagger UI에서 API를 호출하려면 아래 인증 절차를 따릅니다:
1.
Swagger 우측 상단의 [Authorize] 클릭
2.
팝업 창에 제공된 인증 정보(ID / PW) 입력
3.
다시 [Authorize] 클릭하여 인증
4.
완료 후 [Close] 클릭
인증이 완료되면 Swagger에서 실행되는 모든 API 요청은 자동으로 인증 토큰이 포함되어 전송됩니다.
Port 상세 정보 조회 방법
1. Swagger UI 실행 절차
1.
Swagger 문서의 Select a definition 메뉴에서 Port 선택
2.
/port/{portId} 경로로 이동
3.
[Try it Out] 클릭
4.
요청 파라미터 입력
•
portId: UUID 형식의 내부 Port 식별자
5.
[Execute] 클릭
6.
하단에서 응답 결과 확인
2. 요청 파라미터
파라미터명 | 필수 | 설명 |
portId | | UUID 형식의 SeaVantage 고유 항구 식별자 |
응답 정보
응답 예시
{
"code": 200,
"message": "OK",
"error": false,
"timestamp": "2024-12-01T12:00:00",
"response": [
{
"portId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"portName": "Busan",
"unlocode": "KRPUS",
"portAlias": "Busan",
"nationCode": "KR",
"latitude": 35.1796,
"longitude": 129.0756,
"timezone": "+09:00",
"timezoneName": "Asia/Seoul",
"geoData": "{\"type\":\"Polygon\",\"coordinates\":[126.491341,33.499621]}"
}
]
}
JSON
복사
응답 필드 설명
필드명 | 예시 | 설명 |
code | 200 | HTTP 상태 코드 |
message | OK | 응답 메시지 |
error | false | 오류 여부 |
timestamp | 2024-12-01T12:00:00 | 응답 생성 시각 (UTC 기준) |
response | Object[] | 해당 portId에 대한 상세 항구 정보 |
Depth 1 – 항구 상세 필드
필드명 | 예시 값 | 설명 |
portId | 3fa85f64-5717-4562-b3fc-2c963f66afa6 | SeaVantage 내부 Port 식별자 |
portName | Busan | 항구명 |
unlocode | KRPUS | UNLOCODE |
portAlias | Busan | 항구 별칭 (대체명) |
nationCode | KR | 국가 코드 (ISO-3166-1 alpha-2) |
latitude | 35.1796 | 위도 |
longitude | 129.0756 | 경도 |
timezone | +09:00 | 시간대 (UTC 오프셋) |
timezoneName | Asia/Seoul | 시간대 이름 |
geoData | { "type": "Polygon", ... } | 항구 영역의 GeoJSON 좌표 |
응답 코드 안내
코드 | 설명 |
200 | 정상 처리 |
201 | 리소스 생성 |
400 | 잘못된 요청 |
401 | 인증 실패 |
403 | 권한 없음 |
422 | 처리 불가 |
429 | 호출 한도 초과 |