POST /deletebase/{base_camp_id}
端点: POST /v1/pdapi/deletebase/<base_camp_id>
认证: Bearer 令牌
权限: REST.Base.Delete
用途
通过 Base Camp ID 删除基地/营地。这是破坏性管理员操作。
路径参数
base_camp_id: 基地标识符,通常从公会或基地数据中复制。
查询参数
无。
请求体
可选的空 JSON 对象。发送请求前请确认 ID。
响应结构
200 响应架构
| 字段 | 类型 | 描述 |
|---|---|---|
BaseCamp |
object | 已删除基地的摘要。 |
Deleted |
object | 已删除基地数据的清理计数。 |
Archive |
string | 已生成审计归档的路径。 |
BaseCamp 对象架构:
| 字段 | 类型 | 描述 |
|---|---|---|
Id |
string | 基地 GUID。 |
Summary |
string | 便于阅读的基地摘要。 |
Deleted 对象架构:
| 字段 | 类型 | 描述 |
|---|---|---|
BaseCampPals |
integer | 已删除的基地帕鲁数量。 |
StorageContainers |
integer | 已清空的储物容器数量。 |
ItemStacks |
integer | 已删除的物品堆数量。 |
ItemCount |
integer | 已删除的物品总数。 |
Buildings |
integer | 已删除的建筑数量。 |
DropItems |
integer | 已删除的掉落物品 Actor 数量。 |
DefenseModels |
integer | 已删除的防御模型数量。 |
OtherMapObjects |
integer | 已删除的其他地图对象数量。 |
PalBox |
boolean | 是否删除了基地终端。 |
错误响应
错误响应使用以下格式:
| 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 |
The base_camp_id path value is not a valid GUID. |
500 |
BASE_CAMP_MANAGER_UNAVAILABLE |
服务器无法访问 UPalBaseCampManager。 |
404 |
BASE_CAMP_NOT_FOUND |
没有基地与提供的 GUID 匹配。 |
500 |
DELETE_BASE_FAILED |
已找到 Base Camp,但销毁/清理失败。 |
示例
按 GUID 删除基地
按 GUID 删除另一个基地
使用场景
- 经管理人员审核后移除废弃或损坏的基地。
- 删除前使用 GET /guilds 和 GET /guild 确认正确的营地。
- 除非管理流程已验证所有权和备份,否则不要将此端点用于例行清理。