GET /items/{player_identifier}

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

认证: Bearer 令牌

权限: REST.Items.Read

用途

列出目标玩家的物品。响应中的物品标识可在 paldeck.cc/items 查询。

路径参数

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

查询参数

无。

请求体

无请求体。

响应结构

200 响应架构

字段	类型	描述
Meta	object	目标玩家元数据。
Inventory	object	目标玩家的库存容器。

Meta 对象架构：

字段	类型	描述
PlayerUID	string	Palworld 存档数据使用的玩家 UID。
Player	string	请求路径中提供的玩家标识符。

Inventory 对象架构：

字段	类型	描述
Items	object	普通库存容器。
KeyItems	object	关键物品库存容器。
Weapons	object	武器配置库存容器。
Armor	object	护甲库存容器。
Food	object	食物库存容器。
DropSlot	object	丢弃栏库存容器。

库存容器对象架构：

字段	类型	描述
Available	boolean	容器是否可用。
ContainerID	string	Palworld 容器 ID；不可用时为空字符串。
UsedSlots	integer	已占用栏位数。
MaxSlots	integer	栏位总数。
FreeSlots	integer	空闲栏位数。
Slots	object	以栏位索引为键的已占用栏位。

Slots 条目架构：

字段	类型	描述
ItemID	string	Palworld 物品标识符。
Count	integer	栏位中的堆叠数量。

错误响应

错误响应使用以下格式:

{
    "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 秒内完成。

示例

读取 Steam 玩家的库存

GET /v1/pdapi/items/steam_76561198087654321

读取 GDK 玩家的库存

GET /v1/pdapi/items/gdk_2533274812345678

使用场景

• 发放补偿前检查库存。
• 使用 POST /give/items 前确认 ItemID。
• 排查物品缺失报告。