GET /progression/{player_identifier}
Point final : GET /v1/pdapi/progression/<player_identifier>
Auth : Jeton du porteur
Autorisation : REST.Progression.Read
Objectif
Lit les valeurs de progression du joueur telles que l'EXP, l'état lié au niveau, les totaux de reliques et les totaux de points technologiques.
Paramètres du chemin
player_identifier:UserIdouPlayerUIDpour le joueur cible.
Paramètres de requête
Aucun.
Corps de la demande
Aucun corps de requête.
Schéma de réponse
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. |
Réponses aux erreurs
Les corps d'erreur utilisent cette forme :
| HTTP | Code d'erreur | Quand ça arrive |
|---|---|---|
401 |
INVALID_TOKEN |
L'en-tête Authorization est manquant, mal formé ou ne correspond pas à un jeton de support configuré. |
403 |
MISSING_PERMISSION |
Le jeton est valide, mais il n'inclut pas cette autorisation de point de terminaison. |
400 |
INVALID_JSON |
Un corps de requête a été fourni, mais il n'a pas pu être analysé comme JSON. |
400 |
REQUEST_FAILED |
Le joueur cible, le compte, les données de personnage individuel, les données d'enregistrement ou les données technologiques n'ont pas pu être résolus. |
500 |
REQUEST_TIMEOUT |
Le rappel du thread de jeu interne ne s'est pas terminé dans les 5 secondes. |
Exemples
Lire la progression par ID utilisateur PS5
Lire la progression par PlayerUID
Scénarios
- Confirmez les valeurs actuelles avant d’accorder la progression.
- Vérifiez une action d'assistance après POST /give/progression.
- Créez un panneau de présentation des joueurs dans un tableau de bord d'administrateur de confiance.