跳转至

POST /deletebase/{base_camp_id}

端点: POST /v1/pdapi/deletebase/<base_camp_id>

认证: Bearer 令牌

权限: REST.Base.Delete

用途

通过 Base Camp ID 删除基地/营地。这是破坏性管理员操作。

路径参数

  • base_camp_id: Base camp identifier, usually copied from guild/base data.

查询参数

无。

请求体

可选的空 JSON 对象。发送请求前请确认 ID。

响应结构

200 response schema

Field Type Description
BaseCamp object Deleted base camp summary.
Deleted object Cleanup counts for deleted base camp data.
Archive string Path to the generated audit archive.

BaseCamp object schema:

Field Type Description
Id string Base camp GUID.
Summary string Human-readable base camp summary.

Deleted object schema:

Field Type Description
BaseCampPals integer Number of base camp Pals deleted.
StorageContainers integer Number of storage containers cleared.
ItemStacks integer Number of item stacks deleted.
ItemCount integer Total item count deleted.
Buildings integer Number of buildings deleted.
DropItems integer Number of dropped item actors deleted.
DefenseModels integer Number of defense models deleted.
OtherMapObjects integer Number of other map objects deleted.
PalBox boolean Whether the base Palbox was deleted.

错误响应

错误响应使用以下格式:

{
    "Error": {
        "Code": "ERROR_CODE",
        "Message": "人类可读的消息",
        "详情": {}
    }
}
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 No base camp matched the supplied GUID.
500 DELETE_BASE_FAILED 已找到 Base Camp,但销毁/清理失败。

示例

Delete a base camp by GUID

POST /v1/pdapi/deletebase/13b9e8d7-4f2c-42a1-b79e-fc2a9186e4d5

Delete another base camp by GUID

POST /v1/pdapi/deletebase/81c2f0a4-6d7e-49fb-a11d-0d2f9f94b13c

使用场景

  • Remove abandoned or broken bases after staff review.
  • 删除前使用 GET /guildsGET /guild 确认正确的营地。
  • Do not use this endpoint for routine cleanup unless your staff process already verifies ownership and backups.