해당 API는 선박 UUID를 이용하여, 선박이 가장 마지막으로 입항한 항구부터 현재 위치까지의 항로(route) 정보를 반환합니다.
인증 방법
Fleet API는 Swagger UI에서 Basic Authorize 인증 방식을 사용합니다.
인증 절차
1.
Swagger 상단의 [Authorize] 클릭
2.
제공받은 ID / Password 입력
3.
다시 [Authorize] 클릭
4.
인증 완료 후 [Close] 클릭
인증 후 API 요청 시 토큰이 자동 포함되어 전송됩니다.
요청 정보
3-1. 요청 URL
GET
https://insight.seavantage.com/api/ship/past-track/from-last-port
3-2. 실행 순서
1.
Swagger 문서에서 Fleet 정의 선택
2.
/PastTrack 엔드포인트 이동
3.
[Try it Out] 클릭
4.
shipId 입력
•
예시: aaa9dcf0-6af2-4f89-a6d5-c25594ed9837
5.
[Execute] 클릭
6.
하단 응답 확인
shipId는 Ship API에서 확인 가능하며,Fleet API에 등록된 선박만 조회할 수 있습니다.
응답 정보
응답 예시
{
"code": 200,
"message": "OK",
"error": false,
"timestamp": "2025-05-20T02:30:08.713422946",
"response": [
{
"imoNo": "9637076",
"mmsi": "538005248",
"shipName": "ARDMORE SEAVANTAGE",
"longitude": -69.90803833,
"latitude": 12.41267333,
...
}
]
}
JSON
복사
주요 응답 필드 설명
필드명 | 예시 값 | 설명 |
code | 200 | HTTP 상태 코드 |
message | OK | 응답 메시지 |
error | false | 오류 여부 |
timestamp | 2025-05-20T02:30:08Z | 응답 생성 시각 |
response | Array | 선박 항로 정보 목록 |
Depth 1 필드
필드 | 예시 | 설명 |
imoNo | 9637076 | IMO 등록번호 |
mmsi | 538005248 | MMSI 번호 |
deviceType | AIS | AIS 장비 타입 |
shipName | ARDMORE SEAVANTAGE | 선박명 |
latitude / longitude | 12.4126 / -69.9080 | 위치 좌표 |
aisEta | 05182100 | AIS ETA |
timestamp | 2025-05-17T00:57:35Z | 위치 수신 시각 |
speedOverGround | 5.2 | 선박 속도 (노트 단위) |
courseOverGround | 222.2 | 진행 방향 |
aisMaxDraught | 7.8 | 최대 흘수 (단위: m) |
응답 코드 안내
코드 | 설명 |
200 | 정상 처리 |
201 | 생성 완료 |
400 | 잘못된 요청 |
401 | 인증 필요 |
403 | 권한 없음 |
422 | 처리 불가 |
429 | 호출 과다 제한 초과 |
추가 정보
문의 및 기술 지원: sales@seavantage.com