주요 선사, 터미널, 항구의 Booking, B/L, 컨테이너를 추적합니다. 하나의 플랫폼에서 실시간 위치, 정확한 예상 도착 시간(ETA), 그리고 end-to-end 가시성을 제공합니다.
화면 Embed 서비스 사용 순서
1. 토큰 발급
사용자 토큰을 발급합니다.
요청 정보
Request URL: [GET] https://insight.seavantage.com/api/token/publish
실행 순서
1.
2.
/token/publish 경로로 이동합니다.
3.
[Try it out] 을 클릭하여 입력창을 활성화합니다.
4.
[Execute] 버튼 클릭합니다.
5.
응답 영역에서 등록 결과를 확인합니다.
참고 사항
•
토큰은 24시간 동안 유효하며, 지속적인 접근을 위해 일반적으로 12시간에 한 번씩 갱신이 필요합니다.
•
이 API는 여러 번 호출할 수 있으나, 가장 최근에 발급된 두 개의 토큰만 유효하며, 이전에 발급된 토큰은 자동으로 만료됩니다.
2. 임베드 URL 생성
발급된 토큰과 함께 파라미터를 조합하여 화면 임베드 URL을 생성합니다.
파라미터 종류
화면 Embed 기능은 아래 파라미터를 조합하여 다양한 화물 추적 화면을 구성할 수 있습니다. 해당 URL을 브라우저 또는 iframe 에 입력하여 화면 Embed 서비스를 사용할 수 있습니다.
화물 추적시 사용자 토큰과 함께 documentId, mblNo, bookingNo, containerNo 중 하나는 필수로 입력해야 합니다.참고 사항
•
documentId를 통해 화물 추적시 과거 선적까지 조회 가능하므로 해당 값을 통해 추적하시길 권장드립니다.
•
내 워크스페이스에 등록된 선적만 화물 추적이 가능합니다.
userToken (필수)
•
씨벤티지에서 발급된 유효한 사용자 토큰
documentId (선택)
•
선적 식별자 (UUID)
https://insight.seavantage.com/port?portId={documentId}&userToken={userToken}
Plain Text
복사
•
documentId는 선적 등록시 응답값으로 반환됩니다.
mblNo (선택)
•
등록한 mblNo 기준으로 화물을 추적합니다.
https://insight.seavantage.com/cargo/tracking?userToken={userToken}&mblNo={mblNo}
Plain Text
복사
bookingNo (선택)
•
등록한 bookingNo 기준으로 화물을 추적합니다.
https://insight.seavantage.com/cargo/tracking?userToken={userToken}&bookingNo={bookingNo}
Plain Text
복사
containerNo (선택)
•
등록한 containerNo 기준으로 화물을 추적합니다.
https://insight.seavantage.com/cargo/tracking?userToken={userToken}&containerNo={containerNo}
Plain Text
복사
hidePanel (선택)
•
true 입력 시 화면 켜졌을 때 왼쪽 타임라인이 접힌 상태로 켜집니다.
조합 예시
•
컨테이너 값 만 입력 후 추적할 경우
https://insight.seavantage.com/cargo/tracking?userToken={userToken}&containerNo=MSMU5686991
Plain Text
복사
•
컨테이너 값 및 hidePanel 옵션을 적용한 경우
https://insight.seavantage.com/cargo/tracking?userToken={userToken}&hidePanel=true&containerNo=MSMU5686991
Plain Text
복사
