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