지정된 Fleet 카테고리(categoryId)에 등록된 선박(shipId)을 삭제하는 API입니다.
단, 선박은 등록 후 7일이 지나야 삭제할 수 있습니다. 등록 즉시 삭제는 불가능합니다.
요청 방식
•
HTTP Method : DELETE
•
API 경로 : /fleet
•
•
인증 방식 : Basic Auth
•
응답 포맷 : JSON
인증 방법
Swagger UI를 통해 Fleet API를 호출하려면 다음 인증 절차를 따릅니다:
1.
우측 상단 [Authorize] 클릭
2.
팝업창에 ID / PW 입력
3.
[Authorize] 클릭
4.
인증 성공 시 [Close] 클릭
인증이 완료되면 Swagger UI에서 호출되는 모든 API 요청에 토큰이 자동으로 포함됩니다.
선박 삭제 방법
1. Swagger UI 실행 순서
1.
Swagger 문서에서 Fleet 선택
2.
/fleet 항목으로 이동
3.
[Try it Out] 클릭
4.
요청 파라미터 입력
•
categoryId: 삭제 대상 선박이 포함된 카테고리 ID
•
shipId: 삭제할 선박 ID
5.
[Execute] 클릭
6.
하단 응답 결과 확인
categoryId와 shipId는 [GET /fleet] 또는 [GET /fleet/snapshot] API로 확인할 수 있습니다.응답 정보
응답 예시
{
"code": 200,
"message": "OK",
"error": false,
"timestamp": "2024-12-01T12:00:00",
"response": {}
}
JSON
복사
응답 필드 설명
필드명 | 예시 값 | 설명 |
code | 200 | HTTP 상태 코드 |
message | OK | 처리 결과 메시지 |
error | false | 오류 여부 (true = 오류, false = 정상) |
timestamp | 2024-12-01T12:00:00 | 응답 생성 시간 (UTC 기준) |
response | {} | 응답 데이터 (삭제 요청의 경우 비어 있음) |
응답 코드 안내
코드 | 설명 |
200 | 정상 처리 |
201 | 리소스 생성 성공 |
400 | 잘못된 파라미터 |
401 | 인증 실패 |
403 | 권한 없음 |
422 | 삭제 불가 (예: 등록 7일 미만) |
429 | 요청 과다 (Rate limit 초과) |