Zum Inhalt

GET /items/{player_identifier}

Endpunkt: GET /v1/pdapi/items/<player_identifier>

Auth: Bearer-Token

Berechtigung: REST.Items.Read

Zweck

Listet die Items des Zielspielers. Item-Identifier aus Antworten können auf paldeck.cc/items gesucht werden.

Pfadparameter

  • player_identifier: UserId oder PlayerUID des Zielspielers.

Query-Parameter

Keine.

Request-Body

Kein Request-Body.

Antwortschema

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.

Fehlerantworten

Fehlerantworten verwenden dieses Format:

{
    "Error": {
        "Code": "ERROR_CODE",
        "Message": "Für Menschen lesbare Nachricht",
        "Details": {}
    }
}
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, Player State, Inventardaten oder gemeinsamer Inventarcontainer konnten nicht aufgeloest werden.
500 REQUEST_TIMEOUT Der interne Game-Thread-Callback wurde nicht innerhalb von 5 Sekunden abgeschlossen.

Beispiele

Read inventory for a Steam player

GET /v1/pdapi/items/steam_76561198087654321

Read inventory for a GDK player

GET /v1/pdapi/items/gdk_2533274812345678

Szenarien

  • Check inventory before giving compensation.
  • Confirm an ItemID before using POST /give/items.
  • Troubleshoot reports about missing items.