Zum Inhalt

GET /techs/{player_identifier}

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

Auth: Bearer-Token

Berechtigung: REST.Techs.Read

Zweck

Listet Technologieinformationen eines Spielers auf. Technologie-IDs können auf paldeck.cc/technology 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 zur Technologieanzahl des Zielspielers.
Techs object Technologiedaten 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.
UnlockedCount integer Anzahl der derzeit freigeschalteten Technologien.
LockedCount integer Anzahl der derzeit gesperrten Technologien.
TotalCount integer Gesamtzahl der in den Spielerdaten bekannten Rezepttechnologien.

Schema des Techs-Objekts:

Feld Typ Beschreibung
Unlocked string[] Derzeit vom Spieler erlernte Technologie-IDs.

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 Account, Technologiedaten oder Technologietabelle konnten nicht aufgeloest werden.
500 REQUEST_TIMEOUT Der interne Game-Thread-Callback wurde nicht innerhalb von 5 Sekunden abgeschlossen.

Beispiele

Freigeschaltete Technologien anhand der UserID lesen

GET /v1/pdapi/techs/gdk_2533274812345678

Freigeschaltete Technologien anhand der PlayerUID lesen

GET /v1/pdapi/techs/f0a1c3e9-7d5b-4a28-8c33-411fdc2e6b74

Szenarien

  • Vor dem Freischalten oder Entfernen prüfen, ob ein Spieler eine TechID bereits besitzt.
  • Eine Adminseite erstellen, die freigeschaltete und verfügbare Technologien trennt.
  • Den Fortschritt nach Supportmaßnahmen prüfen.