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