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:UserIdoderPlayerUIDdes 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:
| 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
Read inventory for a GDK player
Szenarien
- Check inventory before giving compensation.
- Confirm an
ItemIDbefore using POST /give/items. - Troubleshoot reports about missing items.