Pular para conteúdo

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: UserId ou PlayerUID para 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:

{
    "Error": {
        "Code": "ERROR_CODE",
        "Message": "Human-readable message",
        "Details": {}
    }
}
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

GET /v1/pdapi/items/steam_76561198087654321

Leia o inventário de um jogador GDK

GET /v1/pdapi/items/gdk_2533274812345678

Cenários

  • Verifique o estoque antes de dar compensação.
  • Confirme um ItemID antes de usar POST /give/items.
  • Solucione relatórios de problemas sobre itens ausentes.