Przejdź do treści

GET /pals/{player_identifier}

Punkt końcowy: GET /v1/pdapi/pals/<player_identifier>

Uwierzytelnianie: token Bearer

Wymagane uprawnienie: REST.Pals.Read

Przeznaczenie

Wyświetla Pale wskazanego gracza. Identyfikatory z odpowiedzi można wyszukać na paldeck.cc/pals.

Parametry ścieżki

  • player_identifier: UserId lub PlayerUID docelowego gracza.

Parametry zapytania

Brak.

Treść żądania

Brak treści żądania.

Schemat odpowiedzi

Schemat odpowiedzi 200

Pole Typ Opis
Meta obiekt Metadane wskazanego gracza i liczby Pali.
Pals obiekt Pale wskazanego gracza w drużynie, Palboxie i obozach bazowych.

Meta — schemat obiektu:

Pole Typ Opis
PlayerUID ciąg znaków UID gracza używany w danych zapisu Palworld.
Player ciąg znaków Identyfikator gracza podany w ścieżce żądania.
TeamCount liczba całkowita Liczba Pali w drużynie gracza.
PalboxCount liczba całkowita Liczba Pali w Palboxie gracza.
BaseCampCount liczba całkowita Liczba uwzględnionych obozów bazowych.

Pals — schemat obiektu:

Pole Typ Opis
Team obiekt Pale drużyny według identyfikatora instancji Pala.
Palbox obiekt Pale Palboxa według identyfikatora instancji Pala.
BaseCamps tablica obiektów Obozy bazowe gildii i przypisane do nich pracujące Pale.

Pal — schemat obiektu:

Pole Typ Opis
PalID ciąg znaków Identyfikator gatunku Pala.
UniqueNPCID ciąg znaków Unikalny identyfikator NPC, jeśli jest dostępny.
Nickname ciąg znaków Niestandardowy pseudonim Pala lub pusty ciąg znaków.
SkinId ciąg znaków Identyfikator skórki lub pusty ciąg znaków.
Gender ciąg znaków Płeć Pala.
Level liczba całkowita Poziom Pala.
Exp liczba całkowita EXP Pala.
Shiny wartość logiczna Czy jest to rzadki Pal.
PartnerSkillLevel liczba całkowita Ranga umiejętności partnerskiej.
CondensedPals liczba całkowita Postęp rangi kondensacji.
UnusedStatusPoints liczba całkowita Niewydane punkty atrybutów Pala.
FriendshipPoints liczba całkowita Liczba punktów przyjaźni.
PhysicalHealth ciąg znaków Stan zdrowia fizycznego.
WorkerSick ciąg znaków Stan choroby pracownika.
ImportedCharacter wartość logiczna Czy oznaczono jako zaimportowany.
HP liczba Bieżące HP.
MP liczba Bieżące MP, jeśli jest dostępne.
SP liczba Bieżąca wytrzymałość, jeśli jest dostępna.
Shield liczba Bieżąca wartość osłony, jeśli jest dostępna.
Hunger liczba Bieżąca wartość głodu.
MaxHunger liczba Maksymalna wartość głodu.
SAN liczba Wartość poczytalności.
Support liczba całkowita Wartość wsparcia.
CraftSpeed liczba całkowita Wartość szybkości wytwarzania.
PalSouls obiekt Rangi ulepszeń duszami Pala: Health, Attack, Defense i CraftSpeed.
IVs obiekt Wartości IV: Health, AttackMelee, AttackShot i Defense.
ActiveSkills tablica ciągów znaków Wyposażone umiejętności aktywne.
LearntSkills tablica ciągów znaków Poznane umiejętności.
Passives tablica ciągów znaków Identyfikatory umiejętności pasywnych.
ExtraWorkSuitabilities obiekt Dodatkowe rangi predyspozycji do pracy według identyfikatora predyspozycji.
DisableWorkPreferences tablica ciągów znaków Identyfikatory wyłączonych preferencji pracy.
team_slot_index liczba całkowita Indeks miejsca w drużynie, tylko dla Pali Team.
page liczba całkowita Indeks strony Palboxa, tylko dla Pali Palbox.
slot liczba całkowita Indeks miejsca w Palboxie, tylko dla Pali Palbox.
base_camp_slot_index liczba całkowita Indeks miejsca pracownika obozu bazowego, tylko dla Pali obozu bazowego.

BaseCamps[] — schemat elementu:

Pole Typ Opis
id ciąg znaków GUID obozu bazowego.
level liczba całkowita Poziom obozu bazowego.
world_pos obiekt Współrzędne obozu bazowego w świecie.
map_pos obiekt Przeliczone współrzędne mapy.
state ciąg znaków Bieżący stan obozu bazowego.
pals obiekt Pale pracujące w obozie bazowym według identyfikatora instancji Pala.

Współrzędne — schemat obiektu:

Pole Typ Opis
x liczba Współrzędna X.
y liczba Współrzędna Y.
z liczba Współrzędna Z.

Odpowiedzi błędów

Treść odpowiedzi błędu ma następującą postać:

{
    "Error": {
        "Code": "ERROR_CODE",
        "Message": "Czytelny opis błędu",
        "Details": {}
    }
}
HTTP Kod błędu Kiedy występuje
401 INVALID_TOKEN Brakuje nagłówka Authorization, ma on nieprawidłowy format lub nie odpowiada żadnemu skonfigurowanemu tokenowi Bearer.
403 MISSING_PERMISSION Token jest prawidłowy, ale nie ma uprawnienia wymaganego przez ten punkt końcowy.
400 INVALID_JSON Przesłano treść żądania, ale nie można jej odczytać jako JSON.
400 REQUEST_FAILED Funkcja wywołana w wątku gry zgłosiła wyjątek lub wspólny mechanizm wyszukiwania gracza/zasobu zakończył się niepowodzeniem.
500 REQUEST_TIMEOUT Wewnętrzna funkcja wywołana w wątku gry nie zakończyła się w ciągu 5 sekund.
404 PLAYER_NOT_FOUND Nie znaleziono gracza online o podanym player_identifier.
404 PLAYER_STATE_NOT_FOUND Gracz istnieje, ale jego APalPlayerState jest niedostępny.

Przykłady

Odczyt Pali gracza PS5

GET /v1/pdapi/pals/ps5_0f4b8c2d91aa34ef

Odczyt Pali według PlayerUID

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

Przykładowe zastosowania

  • Sprawdzanie gracza przed udzieleniem pomocy.
  • Sprawdzenie otrzymania Pala po użyciu POST /give/pals lub POST /give/paltemplate.
  • Wyjaśnianie zgłoszeń dotyczących brakujących lub nieoczekiwanych Pali.