GET /progression/{player_identifier}

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

认证: Bearer 令牌

权限: REST.Progression.Read

用途

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

无。

无请求体。

Field	Type	Description
`Meta`	object	Target player metadata.
`Progression`	object	Progression, currency, defeat, capture, and activity data.

Meta object schema:

Field	Type	Description
`PlayerUID`	string	Player UID used by Palworld save data.
`Player`	string	Player identifier supplied in the request path.

Progression object schema:

Field	Type	Description
`Player`	object	Player level, EXP, and unused status points.
`Currencies`	object	Relic and technology point totals.
`Bosses`	object	Boss defeat counters and flags.
`Captures`	object	Pal capture and butcher counters.
`Activities`	object	Crafting, dungeon, fishing, treasure, and other activity counters.

Progression.Player object schema:

Progression.Currencies object schema:

Field	Type	Description
`relics`	object	Relic point totals keyed by relic type.
`technologyPoints`	integer	Technology point total.
`ancientTechnologyPoints`	integer	Ancient technology point total.

Progression.Bosses object schema:

Field	Type	Description
`towerBossDefeatCounts`	object	Tower boss defeat counts keyed by boss ID.
`normalBossDefeatFlags`	object	Normal boss defeat flags keyed by boss ID.
`raidBossDefeatCounts`	object	Raid boss defeat counts keyed by boss ID.
`totalBossDefeatCount`	integer	Sum of tower boss defeat counts.
`predatorDefeatCount`	integer	Predator defeat count.

Progression.Captures object schema:

Field	Type	Description
`tribeCaptureCount`	integer	Total tribe capture count.
`palCaptureCounts`	object	Pal capture counts keyed by Pal ID.
`palCaptureBonusCounts`	object	Pal capture bonus counts keyed by Pal ID.
`palButcherCounts`	object	Pal butcher counts keyed by Pal ID.

Progression.Activities object schema:

Field	Type	Description
`craftItemCounts`	object	Crafted item counts keyed by item ID.
`normalDungeonClearCount`	integer	Normal dungeon clear count.
`fixedDungeonClearCount`	integer	Fixed dungeon clear count.
`oilrigClearCount`	integer	Oil rig clear count.
`palRankUpCounts`	object	Pal rank-up counts keyed by Pal ID.
`arenaSoloClearCounts`	object	Arena solo clear counts keyed by arena ID.
`npcTalkCounts`	object	NPC talk counts keyed by NPC ID.
`fishingCounts`	object	Fishing counts keyed by fish ID.
`foundTreasureCount`	integer	Found treasure count.
`campConqueredCount`	integer	Camp conquered count.
`firstFishingComplete`	boolean	Whether first fishing completion is recorded.

错误响应使用以下格式:

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

GET /v1/pdapi/progression/ps5_c481a77e22004b9d

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