GET /items/{player_identifier}
Ponto final: GET /v1/pdapi/items/<player_identifier>
Autenticação: Token do portador
Permissão: REST.Items.Read
Objetivo
Lista os itens do jogador alvo. Os identificadores de itens nas respostas podem ser pesquisados em paldeck.cc/items.
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. |
Inventory |
object | Inventory containers for the target player. |
Meta object schema:
| Field | Type | Description |
|---|---|---|
PlayerUID |
string | Player UID used by Palworld save data. |
Player |
string | Player identifier supplied in the request path. |
Inventory object schema:
| Field | Type | Description |
|---|---|---|
Items |
object | Common inventory container. |
KeyItems |
object | Key item inventory container. |
Weapons |
object | Weapon loadout inventory container. |
Armor |
object | Armor inventory container. |
Food |
object | Food inventory container. |
DropSlot |
object | Drop slot inventory container. |
Inventory container object schema:
| Field | Type | Description |
|---|---|---|
Available |
boolean | Whether the container was available. |
ContainerID |
string | Palworld container ID, or an empty string when unavailable. |
UsedSlots |
integer | Number of occupied slots. |
MaxSlots |
integer | Total slot count. |
FreeSlots |
integer | Number of free slots. |
Slots |
object | Occupied slots keyed by slot index. |
Slots item schema:
| Field | Type | Description |
|---|---|---|
ItemID |
string | Palworld item identifier. |
Count |
integer | Stack count in the slot. |
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, o estado do jogador, os dados de inventário ou o contêiner de inventário comum 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 o inventário de um jogador Steam
Leia o inventário de um jogador GDK
Cenários
- Verifique o estoque antes de dar compensação.
- Confirme um
ItemIDantes de usar POST /give/items. - Solucione relatórios de problemas sobre itens ausentes.