GET /progression/{player_identifier}

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

认证: Bearer 令牌

权限: REST.Progression.Read

用途

读取玩家进度值，例如 EXP、等级相关状态、遗物总数和科技点总数。

路径参数

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

查询参数

无。

请求体

无请求体。

响应结构

200 响应架构

字段	类型	描述
Meta	object	目标玩家元数据。
Progression	object	进度、货币、击败、捕获和活动数据。

Meta 对象架构：

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

Progression 对象架构：

字段	类型	描述
Player	object	玩家等级、经验值和未使用的属性点。
Currencies	object	遗物点和科技点总计。
Bosses	object	Boss 击败计数和标记。
Captures	object	帕鲁捕获和屠宰计数。
Activities	object	制作、地下城、钓鱼、宝藏及其他活动计数。

Progression.Player 对象架构：

字段	类型	描述
level	integer	当前玩家等级。
exp	integer	当前经验值。
unusedStatusPoints	integer	玩家未使用的属性点。

Progression.Currencies 对象架构：

字段	类型	描述
relics	object	以遗物类型为键的遗物点数总计。
technologyPoints	integer	科技点总计。
ancientTechnologyPoints	integer	古代科技点总计。

Progression.Bosses 对象架构：

字段	类型	描述
towerBossDefeatCounts	object	以 Boss ID 为键的高塔 Boss 击败次数。
normalBossDefeatFlags	object	以 Boss ID 为键的普通 Boss 击败标记。
raidBossDefeatCounts	object	以 Boss ID 为键的突袭 Boss 击败次数。
totalBossDefeatCount	integer	高塔 Boss 击败次数之和。
predatorDefeatCount	integer	掠食者击败次数。

Progression.Captures 对象架构：

字段	类型	描述
tribeCaptureCount	integer	部落捕获总数。
palCaptureCounts	object	以帕鲁 ID 为键的捕获次数。
palCaptureBonusCounts	object	以帕鲁 ID 为键的捕获奖励次数。
palButcherCounts	object	以帕鲁 ID 为键的屠宰次数。

Progression.Activities 对象架构：

字段	类型	描述
craftItemCounts	object	以物品 ID 为键的制作数量。
normalDungeonClearCount	integer	普通地下城通关次数。
fixedDungeonClearCount	integer	固定地下城通关次数。
oilrigClearCount	integer	Oil Rig 通关次数。
palRankUpCounts	object	以帕鲁 ID 为键的升阶次数。
arenaSoloClearCounts	object	以竞技场 ID 为键的单人通关次数。
npcTalkCounts	object	以 NPC ID 为键的对话次数。
fishingCounts	object	以鱼类 ID 为键的钓鱼次数。
foundTreasureCount	integer	找到宝藏的次数。
campConqueredCount	integer	征服营地的次数。
firstFishingComplete	boolean	是否已记录首次完成钓鱼。

错误响应

错误响应使用以下格式:

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

示例

按 PS5 UserID 读取进度

GET /v1/pdapi/progression/ps5_c481a77e22004b9d

按 PlayerUID 读取进度

GET /v1/pdapi/progression/92b8f6ac-1a3d-4a9e-8f52-cc741db8c20a

使用场景

• 授予进度前确认当前数值。
• 在 POST /give/progression 后验证支持操作。
• 在可信的管理面板中构建玩家概览。