API EVE Online. /eve/CharacterID.xml.aspx

Общая информация

Функция возвращает идентификатор сущности, соответствующий имени в запросе. Идентификатор, в зависимости от ситуации, можно интерпретировать по-разному. Так, в случае запроса идентификатора персонажа, корпорации, альянса или фракции, значение characterID можно интерпретировать как значение ownerID. В случае же, когда запрашивается идентификатор объекта (станция, предмет в игре), characterID можно понимать как typeID.

Кэширование

Функция использует M-Short-кэширование.

Параметры вызова

Имя Тип данных Обязательность указания Описание
names string Обязательный параметр Список имён/названий, разделённых запятыми. Если среди списка встретится имя, содержащее недопустимые символы, будет возвращено сообщение об ошибке, даже если остальные имена в строке запроса корректны.

Пример возвращаемых данных

  1. <?xml version='1.0' encoding='UTF-8'?>
  2. <eveapi version="2">
  3.   <currentTime>2011-07-14 23:02:01</currentTime>
  4.   <result>
  5.     <rowset name="characters" key="characterID" columns="name,characterID">
  6.       <row name="Heritor Skoliya" characterID="1770043567" />
  7.       <row name="Skoliyan Industry" characterID="945792655" />
  8.       <row name="Caldari State" characterID="500001" />
  9.     </rowset>
  10.   </result>
  11.   <cachedUntil>2011-08-14 23:02:01</cachedUntil>
  12. </eveapi>

Описание полей XML-файла

Набор строк "characters"

Имя Тип данных Описание
name string Имя сущности
characterID int Идентификатор сущности. Идентификатор, в зависимости от ситуации, можно интерпретировать по-разному. Так, в случае запроса идентификатора персонажа, корпорации, альянса или фракции, значение characterID можно интерпретировать как значение ownerID. В случае же, когда запрашивается идентификатор объекта (станция, предмет в игре), characterID можно понимать как typeID.

Дополнительная информация

Возможные ошибки

Вызов функции без параметров, либо вызов, содержащий в параметрах запроса недопустимые символы, возвращает ошибку:

  1. <?xml version='1.0' encoding='UTF-8'?>
  2. <eveapi version="2">
  3.   <currentTime>2011-07-15 00:02:23</currentTime>
  4.   <error code="122">Invalid or missing list of names.</error>
  5.   <cachedUntil>2011-07-15 00:07:23</cachedUntil>
  6. </eveapi>

Самостоятельное получение данных

Вы можете самостоятельно получить данные используя следующую форму:

Запрос файла https://api.eveonline.com/eve/CharacterID.xml.aspx
names

Похожие материалы

Категория: Разработчикам | Добавил: Heritor (15 Июль 2011) | Автор: Heritor Skoliya E W
Просмотров: 2334 | Теги: eve api | Рейтинг: 0.0/0
Всего комментариев: 0
Добавлять комментарии могут только зарегистрированные пользователи.
[ Регистрация | Вход ]
»Рубрики«
Новичкам [21]
Информация о том как начать играть и как освоиться в игре
Таблицы [10]
Различная сводная информация
Расы [8]
Описание рас Нового Эдема
Хроники [96]
Хроники мира EVE Online. Перевод хроник официального сайта игры
Разработчикам [27]
API, IGB, технологии
Рассказы [1]
Творчество автора данного сайта
Разное [8]
Материалы общего характера
»Поиск«
»Ссылки«
»О сайте«

SKOLI.ru — русский фан сайт игры EVE Online. Статьи и новости с официального сайта eve-online о мире Нового Эдема, гайды, переводы хроник EVE, скриншоты и обои, амбиентная музыка из игры, видео.

»Статистика«

© 2008-2017 SKOLI.RU
Обязательна ссылка на источник, если вы используете материалы, расположенные на данном сайте.
COPYRIGHT NOTICE
EVE Online, the EVE logo, EVE and all associated logos and designs are the intellectual property of CCP hf. All artwork, screenshots, characters, vehicles, storylines, world facts or other recognizable features of the intellectual property relating to these trademarks are likewise the intellectual property of CCP hf. EVE Online and the EVE logo are the registered trademarks of CCP hf. All rights are reserved worldwide. All other trademarks are the property of their respective owners. CCP hf. is not in any way affiliated with, Skoli.ru. CCP is in no way responsible for the content on or functioning of this website, nor can it be liable for any damage arising from the use of this website.