GET /progression/{player_identifier}
Endpunkt: GET /v1/pdapi/progression/<player_identifier>
Auth: Bearer-Token
Berechtigung: REST.Progression.Read
Zweck
Liest Fortschrittswerte eines Spielers wie EXP, levelbezogenen Status, Reliktsummen und Technologiepunkte.
Pfadparameter
player_identifier:UserIdoderPlayerUIDdes Zielspielers.
Query-Parameter
Keine.
Request-Body
Kein Request-Body.
Antwortschema
200 response schema
| 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:
| Field | Type | Description |
|---|---|---|
level |
integer | Current player level. |
exp |
integer | Current EXP value. |
unusedStatusPoints |
integer | Unused player status points. |
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. |
Fehlerantworten
Fehlerantworten verwenden dieses Format:
| HTTP | Fehlercode | Wann es passiert |
|---|---|---|
401 |
INVALID_TOKEN |
Der Authorization-Header fehlt, ist fehlerhaft oder passt zu keinem konfigurierten Bearer-Token. |
403 |
MISSING_PERMISSION |
Das Token ist gültig, enthält aber nicht die Berechtigung für diesen Endpunkt. |
400 |
INVALID_JSON |
Ein Request-Body wurde gesendet, konnte aber nicht als JSON gelesen werden. |
400 |
REQUEST_FAILED |
Zielspieler, Account, individuelle Charakterdaten, Record-Daten oder Technologiedaten konnten nicht aufgeloest werden. |
500 |
REQUEST_TIMEOUT |
Der interne Game-Thread-Callback wurde nicht innerhalb von 5 Sekunden abgeschlossen. |
Beispiele
Read progression by PS5 UserID
Read progression by PlayerUID
Szenarien
- Confirm the current values before granting progression.
- Verify a support action after POST /give/progression.
- Build a player overview panel in a trusted admin dashboard.