/status/

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

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

Статус сервера EVE Online

GET /status/

Статус сервера EVE Server: количество игроков, версия, время с момента последнего перезапуска, VIP-режим

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

Адреса URL

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

  • https://esi.evetech.net/latest/status/
  • https://esi.evetech.net/dev/status/
  • https://esi.evetech.net/legacy/status/
  • https://esi.evetech.net/v1/status/
  • https://esi.evetech.net/v2/status/

Параметры

НазваниеТипПозицияОписание
datasourcestringGET-параметр

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

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

  • tranquility

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

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

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

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

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

200 Статус сервера

Статус сервера

Заголовки HTTP
  • Cache-Control
    The caching mechanism used
  • ETag
    RFC7232 compliant entity tag
  • Expires
    RFC7231 formatted datetime string
  • Last-Modified
    RFC7231 formatted datetime string
Пример:
{
    "players": 12345,
    "server_version": "1132976",
    "start_time": "2017-01-02T12:34:56Z"
}
Структура

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

Item #1

Тип: object. Поля:

  • playersinteger

    Current online player count

  • server_versionstring

    Running version as string

  • start_timestring

    Server start timestamp

  • vipboolean

    If the server is in VIP mode

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

    Детали ошибки

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

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