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。 |
错误响应
错误响应使用以下格式:
| HTTP | 错误代码 | 发生条件 |
|---|---|---|
401 |
INVALID_TOKEN |
Authorization 头缺失、格式错误,或与配置的 Bearer 令牌不匹配。 |
403 |
MISSING_PERMISSION |
令牌有效,但不包含此端点权限。 |
400 |
INVALID_JSON |
提供了请求体,但无法解析为 JSON。 |
400 |
REQUEST_FAILED |
无法解析目标玩家、玩家账号、科技数据或科技表。 |
500 |
REQUEST_TIMEOUT |
内部游戏线程回调未在 5 秒内完成。 |
示例
按 UserID 读取已解锁科技
按 PlayerUID 读取已解锁科技
使用场景
- 解锁或移除前,检查玩家是否已有该
TechID。 - 构建一个区分已解锁和可用科技的管理页面。
- 支持操作后审计进度。