Przejdź do treści

GET /items/{player_identifier}

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

Uwierzytelnianie: token Bearer

Wymagane uprawnienie: REST.Items.Read

Przeznaczenie

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

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.
Inventory obiekt Pojemniki ekwipunku wskazanego gracza.

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.

Inventory — schemat obiektu:

Pole Typ Opis
Items obiekt Pojemnik zwykłego ekwipunku.
KeyItems obiekt Pojemnik przedmiotów kluczowych.
Weapons obiekt Pojemnik wyposażonej broni.
Armor obiekt Pojemnik pancerza.
Food obiekt Pojemnik jedzenia.
DropSlot obiekt Pojemnik miejsca upuszczania.

Pojemnik ekwipunku — schemat obiektu:

Pole Typ Opis
Available wartość logiczna Czy pojemnik był dostępny.
ContainerID ciąg znaków Identyfikator pojemnika Palworld lub pusty ciąg znaków, jeśli jest niedostępny.
UsedSlots liczba całkowita Liczba zajętych miejsc.
MaxSlots liczba całkowita Łączna liczba miejsc.
FreeSlots liczba całkowita Liczba wolnych miejsc.
Slots obiekt Zajęte miejsca według indeksu miejsca.

Slots — schemat elementu:

Pole Typ Opis
ItemID ciąg znaków Identyfikator przedmiotu Palworld.
Count liczba całkowita Liczba sztuk w stosie w miejscu.

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 Nie uzyskano dostępu do wskazanego gracza, jego stanu, danych ekwipunku lub wspólnego pojemnika ekwipunku.
500 REQUEST_TIMEOUT Wewnętrzna funkcja wywołana w wątku gry nie zakończyła się w ciągu 5 sekund.

Przykłady

Odczyt ekwipunku gracza Steam

GET /v1/pdapi/items/steam_76561198087654321

Odczyt ekwipunku gracza GDK

GET /v1/pdapi/items/gdk_2533274812345678

Przykładowe zastosowania

  • Sprawdzanie ekwipunku przed przyznaniem rekompensaty.
  • Sprawdzenie ItemID przed użyciem POST /give/items.
  • Wyjaśnianie zgłoszeń dotyczących brakujących przedmiotów.