Zum Inhalt

GET /progression/{player_identifier}

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

Auth: Bearer-Token

Berechtigung: REST.Progression.Read

Zweck

Liest Fortschrittswerte eines Spielers wie EXP, levelbezogenen Status, Reliktsummen und Technologiepunkte.

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.
Progression object Fortschritts-, Währungs-, Besiegungs-, Fang- und Aktivitätsdaten.

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 Progression-Objekts:

Feld Typ Beschreibung
Player object Spielerstufe, EXP und ungenutzte Statuspunkte.
Currencies object Summen von Relikt- und Technologiepunkten.
Bosses object Zähler und Marker besiegter Bosse.
Captures object Zähler gefangener und geschlachteter Pals.
Activities object Zähler für Herstellung, Dungeons, Angeln, Schätze und andere Aktivitäten.

Schema des Progression.Player-Objekts:

Feld Typ Beschreibung
level integer Aktuelle Spielerstufe.
exp integer Aktueller EXP-Wert.
unusedStatusPoints integer Ungenutzte Statuspunkte des Spielers.

Schema des Progression.Currencies-Objekts:

Feld Typ Beschreibung
relics object Reliktpunktsummen, nach Relikttyp indiziert.
technologyPoints integer Gesamtzahl der Technologiepunkte.
ancientTechnologyPoints integer Gesamtzahl der antiken Technologiepunkte.

Schema des Progression.Bosses-Objekts:

Feld Typ Beschreibung
towerBossDefeatCounts object Besiegungszahlen der Turmbosse, nach Boss-ID indiziert.
normalBossDefeatFlags object Besiegungsmarker normaler Bosse, nach Boss-ID indiziert.
raidBossDefeatCounts object Besiegungszahlen der Raidbosse, nach Boss-ID indiziert.
totalBossDefeatCount integer Summe der Besiegungszahlen von Turmbossen.
predatorDefeatCount integer Anzahl besiegter Raubtiere.

Schema des Progression.Captures-Objekts:

Feld Typ Beschreibung
tribeCaptureCount integer Gesamtzahl der Stammesfänge.
palCaptureCounts object Pal-Fangzahlen, nach Pal-ID indiziert.
palCaptureBonusCounts object Pal-Fangbonuszahlen, nach Pal-ID indiziert.
palButcherCounts object Schlachtzahlen von Pals, nach Pal-ID indiziert.

Schema des Progression.Activities-Objekts:

Feld Typ Beschreibung
craftItemCounts object Hergestellte Gegenstandsmengen, nach Gegenstands-ID indiziert.
normalDungeonClearCount integer Anzahl abgeschlossener normaler Dungeons.
fixedDungeonClearCount integer Anzahl abgeschlossener fester Dungeons.
oilrigClearCount integer Anzahl abgeschlossener Oil Rigs.
palRankUpCounts object Rangaufstiege von Pals, nach Pal-ID indiziert.
arenaSoloClearCounts object Solo-Abschlüsse von Arenen, nach Arena-ID indiziert.
npcTalkCounts object NPC-Gesprächszahlen, nach NPC-ID indiziert.
fishingCounts object Fangzahlen beim Angeln, nach Fisch-ID indiziert.
foundTreasureCount integer Anzahl gefundener Schätze.
campConqueredCount integer Anzahl eroberter Lager.
firstFishingComplete boolean Gibt an, ob der erste Angelabschluss gespeichert ist.

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

Beispiele

Fortschritt anhand der PS5-UserID lesen

GET /v1/pdapi/progression/ps5_c481a77e22004b9d

Fortschritt anhand der PlayerUID lesen

GET /v1/pdapi/progression/92b8f6ac-1a3d-4a9e-8f52-cc741db8c20a

Szenarien

  • Die aktuellen Werte vor der Vergabe von Fortschritt bestätigen.
  • Eine Supportmaßnahme nach POST /give/progression prüfen.
  • Eine Spielerübersicht in einem vertrauenswürdigen Admin-Dashboard erstellen.