POST /deletebase/{base_camp_id}
엔드포인트: POST /v1/pdapi/deletebase/<base_camp_id>
인증: Bearer 토큰
필요 권한: REST.Base.Delete
용도
거점 ID로 거점을 삭제합니다. 데이터를 삭제하는 관리자 작업입니다.
경로 매개변수
base_camp_id: 거점 식별자입니다. 보통 길드/거점 데이터에서 복사합니다.
쿼리 매개변수
없습니다.
요청 본문
선택적으로 빈 JSON 객체를 보낼 수 있습니다. 요청을 전송하기 전에 ID를 확인하세요.
응답 스키마
200 응답 스키마
| 필드 | 자료형 | 설명 |
|---|---|---|
BaseCamp |
객체 | 삭제된 거점의 요약 정보입니다. |
Deleted |
객체 | 삭제한 거점 데이터의 정리 수량입니다. |
Archive |
문자열 | 생성된 검토용 기록 보관 파일의 경로입니다. |
BaseCamp 객체 스키마:
| 필드 | 자료형 | 설명 |
|---|---|---|
Id |
문자열 | 거점 GUID입니다. |
Summary |
문자열 | 사람이 읽을 수 있는 거점 요약입니다. |
Deleted 객체 스키마:
| 필드 | 자료형 | 설명 |
|---|---|---|
BaseCampPals |
정수 | 삭제한 거점 팰 수입니다. |
StorageContainers |
정수 | 비운 보관 컨테이너 수입니다. |
ItemStacks |
정수 | 삭제한 아이템 스택 수입니다. |
ItemCount |
정수 | 삭제한 아이템의 총수량입니다. |
Buildings |
정수 | 삭제한 건축물 수입니다. |
DropItems |
정수 | 삭제한 떨어진 아이템 액터 수입니다. |
DefenseModels |
정수 | 삭제한 방어 모델 수입니다. |
OtherMapObjects |
정수 | 삭제한 기타 맵 오브젝트 수입니다. |
PalBox |
불리언 | 거점 팰 상자를 삭제했는지 나타냅니다. |
오류 응답
오류 응답 본문은 다음 형식을 사용합니다:
| HTTP | 오류 코드 | 발생 조건 |
|---|---|---|
401 |
INVALID_TOKEN |
Authorization 헤더가 없거나 형식이 잘못되었거나, 설정된 Bearer 토큰과 일치하지 않습니다. |
403 |
MISSING_PERMISSION |
토큰은 유효하지만 이 엔드포인트에 필요한 권한이 없습니다. |
400 |
INVALID_JSON |
요청 본문이 있지만 JSON으로 해석할 수 없습니다. |
400 |
REQUEST_FAILED |
게임 스레드 콜백에서 예외가 발생했거나 공통 플레이어/리소스 확인 처리에 실패했습니다. |
500 |
REQUEST_TIMEOUT |
내부 게임 스레드 콜백이 5초 안에 완료되지 않았습니다. |
400 |
INVALID_BASE_CAMP_ID |
경로의 base_camp_id가 유효한 GUID가 아닙니다. |
500 |
BASE_CAMP_MANAGER_UNAVAILABLE |
서버에서 UPalBaseCampManager에 접근할 수 없습니다. |
404 |
BASE_CAMP_NOT_FOUND |
지정한 GUID와 일치하는 거점이 없습니다. |
500 |
DELETE_BASE_FAILED |
거점을 찾았지만 파괴/정리에 실패했습니다. |
예제
GUID로 거점 삭제
다른 GUID의 거점 삭제
활용 사례
- 운영진 검토 후 방치되거나 손상된 거점을 제거합니다.
- 삭제 전에 GET /guilds와 GET /guild로 대상 거점을 정확히 확인하세요.
- 운영 절차에서 소유권과 백업을 확인하고 있지 않다면 이 엔드포인트를 정기 정리에 사용하지 마세요.