/universe/structures/{structure_id}/

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

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

Информация об объекте в космосе

GET /universe/structures/{structure_id}/

Возвращает информацию о запрошенном космическом объекте, если вы имеете доступ к такой информации. В противном случае возвращается ответ с HTTP-кодом 403 (Нет доступа).

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

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

  • esi-universe.read_structures.v1

Адреса URL

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

  • https://esi.evetech.net/latest/universe/structures/{structure_id}/
  • https://esi.evetech.net/v2/universe/structures/{structure_id}/

Параметры

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

Идентификатор космического объекта

datasourcestringGET-параметр

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

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

  • tranquility

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

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

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

tokenstringGET-параметр

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

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

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
Пример:
{
    "name": "V-3YG7 VI - The Capital",
    "owner_id": 109299958,
    "solar_system_id": 30000142
}
Структура

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

Item #1

Тип: object. Поля:

  • namestring

    The full name of the structure

  • owner_idinteger

    The ID of the corporation who owns this particular structure

  • positionItem #2

    Coordinates of the structure in Cartesian space relative to the Sun, in metres.

  • solar_system_idinteger

    solar_system_id integer

  • type_idinteger

    type_id integer

Item #2

Тип: object. Поля:

  • xnumber

    x number

  • ynumber

    y number

  • znumber

    z number

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

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

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