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

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:

{
    "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

Inventar eines Steam-Spielers lesen

GET /v1/pdapi/items/steam_76561198087654321

Inventar eines GDK-Spielers lesen

GET /v1/pdapi/items/gdk_2533274812345678

Szenarien

  • Das Inventar vor einer Entschädigung prüfen.
  • Eine ItemID vor der Verwendung von POST /give/items bestätigen.
  • Meldungen über fehlende Gegenstände untersuchen.