/characters/{character_id}/assets/
(Текущая версия ESI: 1.21)
Предметы персонажа
GET /characters/{character_id}/assets/
Возвращает список предметов персонажа
Этот метод кэшируется. Время жизни кэша: 3 600 секунд.
Требуемые разрешения
esi-assets.read_assets.v1
Адреса URL
Главный и версионированные адреса.
- https://esi.evetech.net/latest/characters/{character_id}/assets/
- https://esi.evetech.net/dev/characters/{character_id}/assets/
- https://esi.evetech.net/v5/characters/{character_id}/assets/
Параметры
| Название | Тип | Позиция | Описание |
|---|---|---|---|
| character_id (Обязательный) | integer | URL | Идентификатор (ID) персонажа Минимальное значение: 1 |
| datasource | string | GET-параметр | Название сервера, для которого вы хотите получать данные Допустимые значения:
Значение по-умолчанию: |
| If-None-Match | string | HTTP-заголовок | ETag из предыдущего запроса. Если он совпадает с предполагаемым ETag ответа сервера, возвращается ответ с кодом 304 |
| page | integer | GET-параметр | Номер страницы с результатами Значение по-умолчанию: Минимальное значение: 1 |
| token | string | GET-параметр | Токен доступа, если нет возможности установить его в хэдерах HTTP-запроса |
Ответы сервера
ESI задаёт тип ответа сервера с помощью кодов HTTP. Например, для большинства запросов возвращается ответ с кодом 200 в заголовках HTTP, что в самом протоколе HTTP подразумевает успешный ответ. Так же, иногда ESI присылает в ответе дополнительные заголовки HTTP, на которые нужно обращать внимание. Список таких заголовков приводится в разделе «Заголовки HTTP».
200 A flat list of the users assets
A flat list of the users assets
Заголовки HTTP
- Cache-ControlThe caching mechanism used
- ETagRFC7232 compliant entity tag
- ExpiresRFC7231 formatted datetime string
- Last-ModifiedRFC7231 formatted datetime string
- X-PagesMaximum page number
Пример:
[
{
"is_blueprint_copy": true,
"is_singleton": true,
"item_id": 1000000016835,
"location_flag": "Hangar",
"location_id": 60002959,
"location_type": "station",
"quantity": 1,
"type_id": 3516
}
]Структура
Тип данных: array of Item #1
Item #1
Тип: object. Поля:
- is_blueprint_copyboolean
is_blueprint_copy boolean
- is_singletonboolean
is_singleton boolean
- item_idinteger
item_id integer
- location_flagstring
location_flag string
Допустимые значения:
- AssetSafety
- AutoFit
- BoosterBay
- Cargo
- CorporationGoalDeliveries
- CorpseBay
- Deliveries
- DroneBay
- FighterBay
- FighterTube0
- FighterTube1
- FighterTube2
- FighterTube3
- FighterTube4
- FleetHangar
- FrigateEscapeBay
- Hangar
- HangarAll
- HiSlot0
- HiSlot1
- HiSlot2
- HiSlot3
- HiSlot4
- HiSlot5
- HiSlot6
- HiSlot7
- HiddenModifiers
- Implant
- LoSlot0
- LoSlot1
- LoSlot2
- LoSlot3
- LoSlot4
- LoSlot5
- LoSlot6
- LoSlot7
- Locked
- MedSlot0
- MedSlot1
- MedSlot2
- MedSlot3
- MedSlot4
- MedSlot5
- MedSlot6
- MedSlot7
- MobileDepotHold
- QuafeBay
- RigSlot0
- RigSlot1
- RigSlot2
- RigSlot3
- RigSlot4
- RigSlot5
- RigSlot6
- RigSlot7
- ShipHangar
- Skill
- SpecializedAmmoHold
- SpecializedAsteroidHold
- SpecializedCommandCenterHold
- SpecializedFuelBay
- SpecializedGasHold
- SpecializedIceHold
- SpecializedIndustrialShipHold
- SpecializedLargeShipHold
- SpecializedMaterialBay
- SpecializedMediumShipHold
- SpecializedMineralHold
- SpecializedOreHold
- SpecializedPlanetaryCommoditiesHold
- SpecializedSalvageHold
- SpecializedShipHold
- SpecializedSmallShipHold
- StructureDeedBay
- SubSystemBay
- SubSystemSlot0
- SubSystemSlot1
- SubSystemSlot2
- SubSystemSlot3
- SubSystemSlot4
- SubSystemSlot5
- SubSystemSlot6
- SubSystemSlot7
- Unlocked
- Wardrobe
- location_idinteger
location_id integer
- location_typestring
location_type string
Допустимые значения:
- station
- solar_system
- item
- other
- quantityinteger
quantity integer
- type_idinteger
type_id integer
304 Без изменений (Not modified)
Без изменений (Not modified)
Заголовки HTTP
- Cache-ControlThe caching mechanism used
- ETagRFC7232 compliant entity tag
- ExpiresRFC7231 formatted datetime string
- Last-ModifiedRFC7231 formatted datetime string
400 Неправильный запрос (Bad request)
Неправильный запрос (Bad request)
Пример:
{
"error": "Bad request message"
}Структура
Тип данных: Item #1
Item #1
Тип: object. Поля:
- errorstring
Детали ошибки
401 Требуется авторизация (Unauthorized)
Требуется авторизация (Unauthorized)
Пример:
{
"error": "Unauthorized message"
}Структура
Тип данных: Item #1
Item #1
Тип: object. Поля:
- errorstring
Детали ошибки
403 Нет доступа (Forbidden)
Нет доступа (Forbidden)
Пример:
{
"error": "Forbidden message"
}Структура
Тип данных: Item #1
Item #1
Тип: object. Поля:
- errorstring
Детали ошибки
- sso_statusinteger
Код статуса из SSO
404 Requested page does not exist
Requested page does not exist
Пример:
{
"error": "Requested page does not exist"
}Структура
Тип данных: Item #1
Item #1
Тип: object. Поля:
- errorstring
error message
420 Лимит исчерпан (Error limited)
Лимит исчерпан (Error limited)
Пример:
{
"error": "Error limited message"
}Структура
Тип данных: Item #1
Item #1
Тип: object. Поля:
- errorstring
Детали ошибки
500 Внутренняя ошибка сервера (Internal server error)
Внутренняя ошибка сервера (Internal server error)
Пример:
{
"error": "Internal server error message"
}Структура
Тип данных: Item #1
Item #1
Тип: object. Поля:
- errorstring
Детали ошибки
503 Сервис недоступен (Service unavailable)
Сервис недоступен (Service unavailable)
Пример:
{
"error": "Service unavailable message"
}Структура
Тип данных: Item #1
Item #1
Тип: object. Поля:
- errorstring
Детали ошибки
504 Сервер не отвечает (Gateway timeout)
Сервер не отвечает (Gateway timeout)
Пример:
{
"error": "Gateway timeout message"
}Структура
Тип данных: Item #1
Item #1
Тип: object. Поля:
- errorstring
Детали ошибки
- timeoutinteger
Количество секунд, потраченные на ожидание ответа