1. API 소개
이 API는 잘못 등록된 화물이거나, 조회 대상에서 제외해야 하는 경우 화물을 삭제할 때 사용됩니다.
삭제된 화물은 시스템에서 완전히 제거되어 더 이상 조회되지 않도록 처리됩니다.
2. 인증 방법
Cargo Insight API는 사용자 인증을 위해 Swagger UI에서 Basic Authorize 인증 방식을 제공합니다.
인증 절차는 다음과 같습니다:
1.
우측 상단의 [Authorize] 버튼을 클릭합니다.
2.
팝업 창에 제공받은 인증 정보(아이디, 비밀번호)를 입력합니다.
3.
입력 후 다시 [Authorize] 버튼을 클릭하여 인증을 진행합니다.
4.
인증이 완료되면 [Close] 버튼을 클릭하여 인증 창을 닫습니다.
Swagger UI에서 호출되는 모든 API 요청에 인증 토큰이 자동으로 포함되어 전송됩니다.
3. 요청 정보
3-1. 요청 정보
Request URL: [DELETE] https://insight.seavantage.com/api/cargo/{documentId}
3-2. 실행 순서
1.
Swagger 문서에서 우측 상단의 Select a definition 메뉴에서 Cargo 선택
2.
/cargo/{documentId} 경로로 이동
3.
[Try it Out] 클릭 → 입력창 활성화
4.
요청 Parameters documentId 값을 입력
5.
[Execute] 버튼 클릭
6.
하단 응답 영역에서 등록 결과 확인
아래 조건을 입력하신 후 [Execute]를 클릭하면 응답 정보를 확인할 수 있습니다.
Parameters
•
4. 응답 정보
요청이 성공하거나 실패했을 때 http 상태 코드로 구분이 가능합니다.
코드 | 설명 |
204 | 정상 처리 (Deleted) |
400 | 잘못된 파라미터 (Bad Request) |
401 | 인증 필요 (Unauthorized) |
403 | 권한 없음 (Forbidden) |
422 | 처리 불가 (Unprocessable Entity) |
429 | 요청 과다 (Too Many Requests) |