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:UserIdlubPlayerUIDdocelowego 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ć:
| 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
Odczyt ekwipunku gracza GDK
Przykładowe zastosowania
- Sprawdzanie ekwipunku przed przyznaniem rekompensaty.
- Sprawdzenie
ItemIDprzed użyciem POST /give/items. - Wyjaśnianie zgłoszeń dotyczących brakujących przedmiotów.