이 API는 입력한 IMO 번호를 기준으로, 현재 기준으로 향후 8주간의 운항 스케줄 정보를 조회합니다. 평균적으로 약 4시간 단위로 업데이트됩니다.
1. 인증 방법
Fleet API는 사용자 인증을 위해 Swagger UI에서 Basic Authorize 인증 방식을 제공합니다.
인증 절차는 다음과 같습니다:
1.
우측 상단의 [Authorize] 버튼을 클릭합니다.
2.
팝업 창에 제공받은 인증 정보(아이디, 비밀번호)를 입력합니다.
3.
입력 후 다시 [Authorize] 버튼을 클릭하여 인증을 진행합니다.
4.
인증이 완료되면 [Close] 버튼을 클릭하여 인증 창을 닫습니다.
Swagger UI에서 호출되는 모든 API 요청에 인증 토큰이 자동으로 포함되어 전송됩니다.
2. 요청 정보
2-1. 요청 정보
Request URL : [GET] https://insight.seavantage.com/api/voyage/schedule
2-2. 실행 순서
1.
2.
/voyage/schedule 경로로 이동
3.
[Try it out] 클릭 → 입력창 활성화
4.
아래 요청 Parameters 조건에 따라 결과 반환
•
선박의 IMO 번호
•
예 : 9619907
5.
[Execute] 버튼 클릭
6.
하단 응답 영역에서 등록 결과 확인
3. 응답 정보
요청이 성공하거나 실패했을 때 공통적으로 아래와 같은 형식으로 응답이 반환됩니다.
응답 예시
{
"code": 200,
"message": "success",
"error": false,
"timestamp": "2025-08-22T02:36:05.554967279",
"response": {
"ship": {
"shipId": "b7ac555e-8b3a-11e9-b34d-54802853d888",
"shipName": "MAERSK MC-KINNEY MOLLER",
"imoNo": "9619907",
"mmsi": "219018271",
"callSign": "OWIZ2"
},
"calls": [
{
"serviceName": "AE1",
"carrierCode": "MAEU",
"voyageNumber": "530W|536E",
"portId": "89d1b0d6-d5df-11e8-890a-7085c2711781",
"portName": "ROTTERDAM",
"unlocode": "NLRTM",
"nationCode": "NL",
"latitude": 51.92649024,
"longitude": 4.22608932,
"timezone": "+01:00",
"terminalId": "291609a9-a994-4b90-b48d-0b09f0d6d3ad",
"terminalName": "APM 2 TERMINAL MAASVLAKTE II",
"eta": "2025-09-01T12:00:00Z",
"etb": null,
"etd": "2025-09-03T04:00:00Z",
"ata": null,
"atb": null,
"atd": null
}
]
}
}
JavaScript
복사
응답 필드 상세 설명
응답 항목별 정의
필드명 | 예시 값 | 설명 |
code | 200 | 응답 상태 코드 (HTTP status code와 동일하게 사용됨)
(아래 별도 응답 코드표 참조) |
message | "OK" | 응답 메시지 (상태에 따른 설명) |
error | false | 오류 여부
(true: 오류 발생, false: 정상 처리) |
timestamp | "2025-05-14T01:09:00.834665213" | 응답 생성 시각 (UTC 기준) |
response | Object 또는 null | 데이터 존재시 Object, 미존재 시 null |
응답 코드 종류
코드 | 설명 |
200 | 정상 처리 (Success) |
400 | 잘못된 파라미터 (Bad Request) |
401 | 인증 필요 (Unauthorized) |
403 | 권한 없음 (Forbidden) |
422 | 처리 불가 (Unprocessable Entity) |
429 | 요청 과다 (Too Many Requests) |
응답 상세 설명
Depth 1 필드 설명 (ship 객체)
필드명 | 예시 값 | 설명 | 데이터 타입 |
shipId | b7ac555e-8b3a-11e9-b34d-54802853d888 | SeaVantage 자체 선박 고유 아이디 | varchar(36) - UUID |
shipName | MAERSK MC-KINNEY MOLLER | 선명 | varchar(100) |
imoNo | 9619907 | 선박 IMO 등록번호 | varchar(10) |
mmsi | 219018271 | 선박 고유 식별 번호 | varchar(10) |
callSign | OWIZ2 | 호출부호 | varchar(7) |
Depth 2 필드 설명 (calls 객체)
필드명 | 예시 값 | 설명 | 데이터 타입 |
serviceName | AE1 | 서비스 항로 | varchar |
carrierCode | MAEU | SCAC 4자리 선사 코드 | varchar(15) |
voyageNumber | 530W|536E | 항차 | varchar(50) |
portId | 89d1b0d6-d5df-11e8-890a-7085c2711781 | 내부적으로 사용하는 Port 구분 값 | varchar(36) - UUID |
portName | ROTTERDAM | 항구명 | varchar(100) |
unlocode | NLRTM | 항구 UNLOCODE | varchar(36) |
nationCode | NL | 코드 | varchar(36) |
latitude | 51.92649024 | 위도 | double precision |
longitude | 4.22608932 | 경도 | double precision |
timezone | +01:00 | 항구 타임존 | varchar(36) |
terminalId | 291609a9-a994-4b90-b48d-0b09f0d6d3ad | 내부적으로 사용하는 Terminal 구분 값 | varchar(36) - UUID |
terminalName | APM 2 TERMINAL MAASVLAKTE II | 터미널명 | varchar(100) |
eta | 2025-09-01T12:00:00Z | 선사에서 수집된
Estimated Time of Arrival | timestamp |
etb | 2025-09-01T12:00:00Z | 선사에서 수집된
Estimated Time of Berthing | timestamp |
etd | 2025-09-01T12:00:00Z | 선사에서 수집된
Estimated Time of Departure | timestamp |
ata | 2025-09-01T12:00:00Z | 씨벤티지 포트콜 데이터로 생성된
Actual Time of Arrival | timestamp |
atb | 2025-09-01T12:00:00Z | 씨벤티지 포트콜 데이터로 생성된
Actual Time of Berthing | timestamp |
atd | 2025-09-01T12:00:00Z | 씨벤티지 포트콜 데이터로 생성된
Actual Time of Departure | timestamp |