/characters/{character_id}/killmails/recent/

- Методы - API игры EVE Online

(Текущая версия ESI: 1.21)

Get a character's recent kills and losses

GET /characters/{character_id}/killmails/recent/

Return a list of a character's kills and losses going back 90 days

Этот метод кэшируется. Время жизни кэша: 300 секунд.

Требуемые разрешения

  • esi-killmails.read_killmails.v1

Адреса URL

Главный и версионированные адреса.

  • https://esi.evetech.net/latest/characters/{character_id}/killmails/recent/
  • https://esi.evetech.net/dev/characters/{character_id}/killmails/recent/
  • https://esi.evetech.net/legacy/characters/{character_id}/killmails/recent/
  • https://esi.evetech.net/v1/characters/{character_id}/killmails/recent/

Параметры

НазваниеТипПозицияОписание
character_id
(Обязательный)
integerURL

Идентификатор (ID) персонажа

Минимальное значение: 1

datasourcestringGET-параметр

Название сервера, для которого вы хотите получать данные

Допустимые значения:

  • tranquility

Значение по-умолчанию: tranquility

If-None-MatchstringHTTP-заголовок

ETag из предыдущего запроса. Если он совпадает с предполагаемым ETag ответа сервера, возвращается ответ с кодом 304

pageintegerGET-параметр

Номер страницы с результатами

Значение по-умолчанию: 1

Минимальное значение: 1

tokenstringGET-параметр

Токен доступа, если нет возможности установить его в хэдерах HTTP-запроса

Ответы сервера

ESI задаёт тип ответа сервера с помощью кодов HTTP. Например, для большинства запросов возвращается ответ с кодом 200 в заголовках HTTP, что в самом протоколе HTTP подразумевает успешный ответ. Так же, иногда ESI присылает в ответе дополнительные заголовки HTTP, на которые нужно обращать внимание. Список таких заголовков приводится в разделе «Заголовки HTTP».

200 A list of killmail IDs and hashes

A list of killmail IDs and hashes

Заголовки HTTP
  • Cache-Control
    The caching mechanism used
  • ETag
    RFC7232 compliant entity tag
  • Expires
    RFC7231 formatted datetime string
  • Last-Modified
    RFC7231 formatted datetime string
  • X-Pages
    Maximum page number
Пример:
[
    {
        "killmail_hash": "8eef5e8fb6b88fe3407c489df33822b2e3b57a5e",
        "killmail_id": 2
    },
    {
        "killmail_hash": "b41ccb498ece33d64019f64c0db392aa3aa701fb",
        "killmail_id": 1
    }
]
Структура

Тип данных: array of Item #1

Item #1

Тип: object. Поля:

  • killmail_hashstring

    A hash of this killmail

  • killmail_idinteger

    ID of this killmail

304 Без изменений (Not modified)

Без изменений (Not modified)

Заголовки HTTP
  • Cache-Control
    The caching mechanism used
  • ETag
    RFC7232 compliant entity tag
  • Expires
    RFC7231 formatted datetime string
  • Last-Modified
    RFC7231 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

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

    Количество секунд, потраченные на ожидание ответа