跳转至

GET /techs/{player_identifier}

端点: GET /v1/pdapi/techs/<player_identifier>

认证: Bearer 令牌

权限: REST.Techs.Read

用途

列出玩家的科技信息。科技标识符可在 paldeck.cc/technology 查询。

路径参数

  • player_identifier: 目标玩家的 UserId 或 PlayerUID。

查询参数

无。

请求体

无请求体。

响应结构

200 响应架构

字段 类型 描述
Meta object 目标玩家的科技数量元数据。
Techs object 目标玩家的科技数据。

Meta 对象架构:

字段 类型 描述
PlayerUID string Palworld 存档数据使用的玩家 UID。
Player string 请求路径中提供的玩家标识符。
UnlockedCount integer 当前已解锁的科技数量。
LockedCount integer 当前未解锁的科技数量。
TotalCount integer 玩家数据已知的配方科技总数。

Techs 对象架构:

字段 类型 描述
Unlocked string[] 玩家当前已学习的科技 ID。

错误响应

错误响应使用以下格式:

{
    "Error": {
        "Code": "ERROR_CODE",
        "Message": "人类可读的消息",
        "Details": {}
    }
}
HTTP 错误代码 发生条件
401 INVALID_TOKEN Authorization 头缺失、格式错误,或与配置的 Bearer 令牌不匹配。
403 MISSING_PERMISSION 令牌有效,但不包含此端点权限。
400 INVALID_JSON 提供了请求体,但无法解析为 JSON。
400 REQUEST_FAILED 无法解析目标玩家、玩家账号、科技数据或科技表。
500 REQUEST_TIMEOUT 内部游戏线程回调未在 5 秒内完成。

示例

按 UserID 读取已解锁科技

GET /v1/pdapi/techs/gdk_2533274812345678

按 PlayerUID 读取已解锁科技

GET /v1/pdapi/techs/f0a1c3e9-7d5b-4a28-8c33-411fdc2e6b74

使用场景

  • 解锁或移除前,检查玩家是否已有该 TechID。
  • 构建一个区分已解锁和可用科技的管理页面。
  • 支持操作后审计进度。