GET /progression/{player_identifier}
Ponto final: GET /v1/pdapi/progression/<player_identifier>
Autenticação: Token do portador
Permissão: REST.Progression.Read
Objetivo
Lê valores de progressão do jogador, como EXP, estado relacionado ao nível, totais de relíquias e totais de pontos de tecnologia.
Parâmetros de caminho
player_identifier:UserIdouPlayerUIDpara o jogador alvo.
Parâmetros de consulta
Nenhum.
Solicitar corpo
Nenhum corpo de solicitação.
Esquema de resposta
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. |
Respostas de erro
Os corpos de erro usam esta forma:
| HTTP | Código de erro | Quando isso acontece |
|---|---|---|
401 |
INVALID_TOKEN |
O cabeçalho Authorization está ausente, malformado ou não corresponde a um token de portador configurado. |
403 |
MISSING_PERMISSION |
O token é válido, mas não inclui essa permissão de endpoint. |
400 |
INVALID_JSON |
Um corpo de solicitação foi fornecido, mas não pôde ser analisado como JSON. |
400 |
REQUEST_FAILED |
O jogador alvo, conta, dados de personagens individuais, dados de registro ou dados de tecnologia não puderam ser resolvidos. |
500 |
REQUEST_TIMEOUT |
O retorno de chamada do thread de jogo interno não foi concluído em 5 segundos. |
Exemplos
Leia a progressão por UserID do PS5
Leia a progressão por PlayerUID
Cenários
- Confirme os valores atuais antes de conceder a progressão.
- Verifique uma ação de suporte após POST /give/progression.
- Crie um painel de visão geral do jogador em um painel de administração confiável.