/universe/regions/{region_id}/

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

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

Информация о регионе

GET /universe/regions/{region_id}/

Возвращает информацию о регионе.

Данные обновляются каждый день в 11:05 UTC.

Адреса URL

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

  • https://esi.evetech.net/latest/universe/regions/{region_id}/
  • https://esi.evetech.net/legacy/universe/regions/{region_id}/
  • https://esi.evetech.net/v1/universe/regions/{region_id}/

Параметры

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

Идентификатор региона

Accept-LanguagestringHTTP-заголовок

Язык, используемый в ответе сервера

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

  • en
  • en-us
  • de
  • fr
  • ja
  • ru
  • zh
  • ko
  • es

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

datasourcestringGET-параметр

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

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

  • tranquility

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

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

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

languagestringGET-параметр

Язык, на котором нужно получать ответ. Этот параметр имеет больший приоритет, чем значение хэдера Accept-Language

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

  • en
  • en-us
  • de
  • fr
  • ja
  • ru
  • zh
  • ko
  • es

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

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

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

200 Информация о регионе

Информация о регионе

Заголовки HTTP
  • Cache-Control
    The caching mechanism used
  • Content-Language
    The language used in the response
  • ETag
    RFC7232 compliant entity tag
  • Expires
    RFC7231 formatted datetime string
  • Last-Modified
    RFC7231 formatted datetime string
Пример:
{
    "constellations": [
        20000302,
        20000303
    ],
    "description": "It has long been an established fact of civilization...",
    "name": "Metropolis",
    "region_id": 10000042
}
Структура

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

Item #1

Тип: object. Поля:

  • constellationsarray of integers

    constellations array

    Максимальное количество элементов: 1 000

  • descriptionstring

    description string

  • namestring

    name string

  • region_idinteger

    region_id integer

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

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

404 Регион не найден

Регион не найден

Пример:
{
    "error": "Not found message"
}
Структура

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

Item #1

Тип: object. Поля:

  • errorstring

    Not found 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

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