화면 설명
주요 선사, 터미널, 항구의 Booking, B/L, 컨테이너를 추적합니다. 하나의 플랫폼에서 실시간 위치, 정확한 예상 도착 시간(ETA), 그리고 end-to-end 가시성을 제공합니다.
화면 Embed 소개
화면 Embed는 씨벤티지에서 발급된 사용자 토큰(User Token)을 활용하여, 별도의 로그인 과정 없이 사용 중인 솔루션 내에 인터페이스 형태로 연동하여 사용할 수 있는 서비스입니다.
화면 Embed 서비스 사용 순서
1.
사용자 토큰을 발급합니다.
2.
발급된 토큰과 함께 파라미터를 조합하여 화면 임베드 URL을 생성합니다.
3.
해당 URL을 브라우저 또는 iframe 에 입력하여 화면 Embed 서비스를 사용할 수 있습니다.
사용자 토큰 발급
요청 정보
Request URL: [GET] https://insight.seavantage.com/api/token/publish
실행 순서
1.
Swagger 문서에 접속합니다.
2.
우측 상단의 [Authorize] 버튼을 클릭합니다.
3.
팝업 창에 제공받은 **인증 정보(아이디, 비밀번호)**를 입력합니다.
4.
입력 후 다시 [Authorize] 버튼을 클릭하여 인증을 진행합니다.
5.
인증이 완료되면 [Close] 버튼을 클릭하여 인증 창을 닫습니다.
[Execute] 클릭 후 발급된 응답 정보를 통해 토큰 값을 확인할 수 있습니다.
참고 사항
•
발급된 토큰은 24시간 유효합니다.
•
많은 수의 토큰 발행 시 마지막 발급된 2개의 토큰만 유효합니다.
화면 임베드 파라미터 조합
화면 Embed 기능은 아래 파라미터를 조합하여 다양한 선박 추적 화면을 구성할 수 있습니다.
조합 예시
•
화물 추적 식별자인 documentId를 통해 화물을 추적합니다.
https://insight.seavantage.com/cargo/tracking?userToken={userToken}&documentId={documentId}
Plain Text
복사
•
Container No를 통해 화물을 추적합니다.
https://insight.seavantage.com/cargo/tracking?userToken={userToken}&containerNo={MSMU5686991}
Plain Text
복사
파라미터 종류
1.
userToken (필수)
•
씨벤티지에서 발급된 유효한 사용자 토큰
2.
documentId (선택)
•
•
이미 등록을 완료 했을 경우 선적 조회시 응답값에 반환됩니다.
3.
mblNo (선택)
•
등록한 B/L No 기준으로 화물을 추적합니다.
4.
bookingNo (선택)
•
등록한 Booking No 기준으로 화물을 추적합니다.
5.
containerNo (선택)
•
등록한 Container No 기준으로 화물을 추적합니다.
참고 사항
•
화물 추적시 사용자 토큰과 함께 documentId, mblNo, bookingNo, containerNo 중 하나는 필수로 입력하셔야 합니다.
•
documentId를 통해 화물 추적시 과거 선적까지 조회 가능하므로 해당 값을 통해 추적하길 권장드립니다.
•
내 워크스페이스에 등록된 선적만 화물 추적이 가능합니다.