GET /items/{player_identifier}
Конечная точка: GET /v1/pdapi/items/<player_identifier>
Аутентификация: Токен носителя
Разрешение: REST.Items.Read
Цель
Перечисляет предметы целевого игрока. Идентификаторы элементов в ответах можно найти на paldeck.cc/items.
Параметры пути
player_identifier:UserIdилиPlayerUIDдля целевого игрока.
Параметры запроса
Нет.
Тело запроса
Нет тела запроса.
Схема ответа
200 response schema
| Field | Type | Description |
|---|---|---|
Meta |
object | Target player metadata. |
Inventory |
object | Inventory containers for the target player. |
Meta object schema:
| Field | Type | Description |
|---|---|---|
PlayerUID |
string | Player UID used by Palworld save data. |
Player |
string | Player identifier supplied in the request path. |
Inventory object schema:
| Field | Type | Description |
|---|---|---|
Items |
object | Common inventory container. |
KeyItems |
object | Key item inventory container. |
Weapons |
object | Weapon loadout inventory container. |
Armor |
object | Armor inventory container. |
Food |
object | Food inventory container. |
DropSlot |
object | Drop slot inventory container. |
Inventory container object schema:
| Field | Type | Description |
|---|---|---|
Available |
boolean | Whether the container was available. |
ContainerID |
string | Palworld container ID, or an empty string when unavailable. |
UsedSlots |
integer | Number of occupied slots. |
MaxSlots |
integer | Total slot count. |
FreeSlots |
integer | Number of free slots. |
Slots |
object | Occupied slots keyed by slot index. |
Slots item schema:
| Field | Type | Description |
|---|---|---|
ItemID |
string | Palworld item identifier. |
Count |
integer | Stack count in the slot. |
Реакции на ошибки
Тела ошибок используют следующую форму:
| HTTP | Код ошибки | Когда это произойдет |
|---|---|---|
401 |
INVALID_TOKEN |
Заголовок Authorization отсутствует, имеет неправильный формат или не соответствует настроенному токену носителя. |
403 |
MISSING_PERMISSION |
Токен действителен, но не включает это разрешение конечной точки. |
400 |
INVALID_JSON |
Текст запроса был предоставлен, но его не удалось проанализировать как JSON. |
400 |
REQUEST_FAILED |
Не удалось определить целевого игрока, состояние игрока, данные инвентаря или общий контейнер инвентаря. |
500 |
REQUEST_TIMEOUT |
Обратный вызов внутреннего игрового потока не завершился в течение 5 секунд. |
Примеры
Чтение инвентаря для игрока Steam
Прочитать инвентарь игрока GDK.
Сценарии
- Проверьте инвентарь, прежде чем давать компенсацию.
- Подтвердите
ItemIDперед использованием POST /give/items. - Устранение неполадок с отчетами об отсутствующих элементах.