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
Schema der 200-Antwort
| Feld | Typ | Beschreibung |
|---|---|---|
Meta |
object | Metadaten des Zielspielers. |
Inventory |
object | Inventarcontainer des Zielspielers. |
Schema des Meta-Objekts:
| Feld | Typ | Beschreibung |
|---|---|---|
PlayerUID |
string | Von den Palworld-Speicherdaten verwendete Spieler-UID. |
Player |
string | In der Anfrage-URL angegebene Spielerkennung. |
Schema des Inventory-Objekts:
| Feld | Typ | Beschreibung |
|---|---|---|
Items |
object | Allgemeiner Inventarcontainer. |
KeyItems |
object | Inventarcontainer für Schlüsselgegenstände. |
Weapons |
object | Inventarcontainer der Waffenausrüstung. |
Armor |
object | Rüstungsinventarcontainer. |
Food |
object | Nahrungsinventarcontainer. |
DropSlot |
object | Inventarcontainer des Ablageplatzes. |
Schema eines Inventarcontainers:
| Feld | Typ | Beschreibung |
|---|---|---|
Available |
boolean | Gibt an, ob der Container verfügbar war. |
ContainerID |
string | Palworld-Container-ID oder eine leere Zeichenfolge, wenn nicht verfügbar. |
UsedSlots |
integer | Anzahl der belegten Plätze. |
MaxSlots |
integer | Gesamtzahl der Plätze. |
FreeSlots |
integer | Anzahl der freien Plätze. |
Slots |
object | Belegte Plätze, nach Platzindex indiziert. |
Schema eines Slots-Eintrags:
| Feld | Typ | Beschreibung |
|---|---|---|
ItemID |
string | Palworld-Gegenstandskennung. |
Count |
integer | Stapelanzahl auf dem Platz. |
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
Inventar eines Steam-Spielers lesen
Inventar eines GDK-Spielers lesen
Szenarien
- Das Inventar vor einer Entschädigung prüfen.
- Eine
ItemIDvor der Verwendung von POST /give/items bestätigen. - Meldungen über fehlende Gegenstände untersuchen.