API EVE Online. /account/Characters.xml.aspx

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

Функция возвращает список персонажей, принадлежащих данному аккаунту, если при создании ключа в поле "Character" было выбрано значение "All". Если ключ создавался под конкретного персонажа, то данная функция выведет описание только этого персонажа. Если при вызове функции указывается корпоративный ключ, то выводится информация о персонаже, который этот ключ создал.

Кэширование

Функция использует Short-кэширование. Время кэширования — чуть меньше часа (по наблюдениям — 57 минут).

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

Имя Тип данных Обязательность указания Описание
keyID int Обязательный параметр Идентификатор API-ключа, который можно узнать на странице Your API Keys официального сайта игры.
vCode char(64) Обязательный параметр Verification Code для соответствующего API-ключа, узнать который можно из таблицы на странице Your API Keys официального сайта игры.

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

  1. <?xml version='1.0' encoding='UTF-8'?>
  2. <eveapi version="1">
  3.   <currentTime>2007-12-12 11:48:50</currentTime>
  4.   <result>
  5.     <rowset name="characters" key="characterID" columns="name,characterID,corporationName,corporationID">
  6.       <row name="Mary" characterID="150267069" corporationName="Starbase Anchoring Corp" corporationID="150279367" />
  7.       <row name="Marcus" characterID="150302299" corporationName="Marcus Corp" corporationID="150333466" />
  8.       <row name="Dieinafire" characterID="150340823" corporationName="Center for Advanced Studies" corporationID="1000169" />
  9.     </rowset>
  10.   </result>
  11.   <cachedUntil>2007-12-12 12:48:50</cachedUntil>
  12. </eveapi>

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

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

Имя Тип данных Описание
name string Имя персонажа
characterID int Идентификатор персонажа
corporationName string Имя корпорации, в которой состоит персонаж
corporationID int Идентификатор корпорации, в которой состоит персонаж

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

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

Вызов функции без параметров возвращает ошибку:

  1. <?xml version='1.0' encoding='UTF-8'?>
  2. <eveapi version="2">
  3.   <currentTime>2011-07-14 20:31:21</currentTime>
  4.   <error code="106">Must provide userID parameter for authentication.</error>
  5.   <cachedUntil>2011-07-14 20:36:21</cachedUntil>
  6. </eveapi>

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

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

Запрос файла https://api.eveonline.com/account/Characters.xml.aspx
vCode
keyID

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

Категория: Разработчикам | Добавил: Heritor (15 Июль 2011) | Автор: Heritor Skoliya E W
Просмотров: 2304 | Теги: eve api | Рейтинг: 5.0/1
Всего комментариев: 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.