Перейти к содержанию

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.

Реакции на ошибки

Тела ошибок используют следующую форму:

{
    "Error": {
        "Code": "ERROR_CODE",
        "Message": "Human-readable message",
        "Details": {}
    }
}
HTTP Код ошибки Когда это произойдет
401 INVALID_TOKEN Заголовок Authorization отсутствует, имеет неправильный формат или не соответствует настроенному токену носителя.
403 MISSING_PERMISSION Токен действителен, но не включает это разрешение конечной точки.
400 INVALID_JSON Текст запроса был предоставлен, но его не удалось проанализировать как JSON.
400 REQUEST_FAILED Не удалось определить целевого игрока, состояние игрока, данные инвентаря или общий контейнер инвентаря.
500 REQUEST_TIMEOUT Обратный вызов внутреннего игрового потока не завершился в течение 5 секунд.

Примеры

Чтение инвентаря для игрока Steam

GET /v1/pdapi/items/steam_76561198087654321

Прочитать инвентарь игрока GDK.

GET /v1/pdapi/items/gdk_2533274812345678

Сценарии

  • Проверьте инвентарь, прежде чем давать компенсацию.
  • Подтвердите ItemID перед использованием POST /give/items.
  • Устранение неполадок с отчетами об отсутствующих элементах.