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

200 response schema

Field Type Description
Meta object Technology count metadata for the target player.
Techs object Technology data 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.
UnlockedCount integer Number of currently unlocked technologies.
LockedCount integer Number of currently locked technologies.
TotalCount integer Total number of recipe technologies known to the player data.

Techs object schema:

Field Type Description
Unlocked string[] Technology IDs currently learned by the player.

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

Read unlocked techs by UserID

GET /v1/pdapi/techs/gdk_2533274812345678

Read unlocked techs by PlayerUID

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

Szenarien

  • Check whether a player already has a TechID before learning or forgetting it.
  • Build an admin page that separates unlocked and available technologies.
  • Audit progression after support actions.