GET /pals/{player_identifier}

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

Auth: Bearer-Token

Berechtigung: REST.Pals.Read

Zweck

Listet die Pals des Zielspielers. Pal-Identifier aus Antworten können auf paldeck.cc/pals 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 und Pal-Anzahlen.
Pals	object	Team-, Palbox- und Basislager-Pals 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.
TeamCount	integer	Anzahl der Pals im Spielerteam.
PalboxCount	integer	Anzahl der Pals in der Palbox des Spielers.
BaseCampCount	integer	Anzahl der enthaltenen Basislager.

Schema des Pals-Objekts:

Feld	Typ	Beschreibung
Team	object	Team-Pals, nach Pal-Instanz-ID indiziert.
Palbox	object	Palbox-Pals, nach Pal-Instanz-ID indiziert.
BaseCamps	object[]	Gildenbasislager und deren zugewiesene Arbeiter-Pals.

Schema eines Pal-Objekts:

Feld	Typ	Beschreibung
PalID	string	Artkennung des Pals.
UniqueNPCID	string	Eindeutige NPC-ID, falls vorhanden.
Nickname	string	Eigener Pal-Spitzname oder eine leere Zeichenfolge.
SkinId	string	Skin-ID oder eine leere Zeichenfolge.
Gender	string	Geschlecht des Pals.
Level	integer	Stufe des Pals.
Exp	integer	EXP des Pals.
Shiny	boolean	Gibt an, ob dies ein seltener Pal ist.
PartnerSkillLevel	integer	Rang der Partnerfähigkeit.
CondensedPals	integer	Fortschritt des Kondensierungsrangs.
UnusedStatusPoints	integer	Ungenutzte Statuspunkte des Pals.
FriendshipPoints	integer	Freundschaftspunktwert.
PhysicalHealth	string	Körperlicher Gesundheitszustand.
WorkerSick	string	Krankheitszustand des Arbeiters.
ImportedCharacter	boolean	Gibt an, ob der Pal als importiert markiert ist.
HP	number	Aktuelle HP.
MP	number	Aktuelle MP, falls vorhanden.
SP	number	Aktuelle Ausdauer, falls vorhanden.
Shield	number	Aktueller Schildwert, falls vorhanden.
Hunger	number	Aktueller Hungerwert.
MaxHunger	number	Maximaler Hungerwert.
SAN	number	Verstandswert.
Support	integer	Unterstützungswert.
CraftSpeed	integer	Herstellungsgeschwindigkeit.
PalSouls	object	Pal-Seelenränge mit Health, Attack, Defense und CraftSpeed.
IVs	object	IV-Werte mit Health, AttackMelee, AttackShot und Defense.
ActiveSkills	string[]	Ausgerüstete aktive Skills.
LearntSkills	string[]	Erlernte Skills.
Passives	string[]	Passive Skill-IDs.
ExtraWorkSuitabilities	object	Zusätzliche Arbeitseignungsränge, nach Eignungs-ID indiziert.
DisableWorkPreferences	string[]	Deaktivierte Arbeitseinstellungs-IDs.
team_slot_index	integer	Teamplatzindex, nur bei Pals unter Team.
page	integer	Palbox-Seitenindex, nur bei Pals unter Palbox.
slot	integer	Palbox-Platzindex, nur bei Pals unter Palbox.
base_camp_slot_index	integer	Arbeiterplatzindex des Basislagers, nur bei Basislager-Pals.

Schema eines BaseCamps[]-Eintrags:

Feld	Typ	Beschreibung
id	string	GUID des Basislagers.
level	integer	Stufe des Basislagers.
world_pos	object	Weltkoordinaten des Basislagers.
map_pos	object	Umgerechnete Kartenkoordinaten.
state	string	Aktueller Zustand des Basislagers.
pals	object	Arbeiter-Pals des Basislagers, nach Pal-Instanz-ID indiziert.

Schema des Koordinatenobjekts:

Feld	Typ	Beschreibung
x	number	X-Koordinate.
y	number	Y-Koordinate.
z	number	Z-Koordinate.

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	Der Game-Thread-Callback hat eine Ausnahme ausgelöst oder ein gemeinsamer Spieler-/Ressourcen-Resolver ist fehlgeschlagen.
500	REQUEST_TIMEOUT	Der interne Game-Thread-Callback wurde nicht innerhalb von 5 Sekunden abgeschlossen.
404	PLAYER_NOT_FOUND	Kein Online-Spieler entsprach dem angegebenen player_identifier.
404	PLAYER_STATE_NOT_FOUND	Der Spieler existiert, aber sein APalPlayerState war nicht verfügbar.

Beispiele

Pals eines PS5-Spielers lesen

GET /v1/pdapi/pals/ps5_0f4b8c2d91aa34ef

Pals anhand der PlayerUID lesen

GET /v1/pdapi/pals/6d2e8b40-73ef-4f11-9bb8-2e91a36e2f09

Szenarien

• Einen Spieler vor Supportmaßnahmen prüfen.
• Nach POST /give/pals oder POST /give/paltemplate bestätigen, dass der Belohnungs-Pal angekommen ist.
• Meldungen über fehlende oder unerwartete Pals untersuchen.