API EVE Online. /char/Research.xml.aspx

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

Эта функция возвращает информацию об агентах, с которыми пилот ведёт исследования в данный момент, включая сюда дату начала исследования и количество очков исследований (RP), начисляемое за день.

Кэширование

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

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

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

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

  1. <?xml version='1.0' encoding='UTF-8'?>
  2. <eveapi version="2">
  3.   <currentTime>2011-07-28 18:52:24</currentTime>
  4.   <result>
  5.     <rowset name="research" key="agentID" columns="agentID, skillTypeID, researchStartDate, pointsPerDay, remainderPoints">
  6.       <row agentID="3011526" skillTypeID="11453" researchStartDate="2011-05-29 13:04:13" pointsPerDay="113.4" remainderPoints="0" />
  7.       <row agentID="3011531" skillTypeID="11453" researchStartDate="2011-05-29 14:44:18" pointsPerDay="113.4" remainderPoints="0" />
  8.       <row agentID="3011534" skillTypeID="11453" researchStartDate="2011-05-29 11:52:06" pointsPerDay="113.4" remainderPoints="0" />
  9.       <row agentID="3016560" skillTypeID="11453" researchStartDate="2011-05-29 14:58:42" pointsPerDay="113.4" remainderPoints="0" />
  10.       <row agentID="3016569" skillTypeID="11453" researchStartDate="2011-05-29 12:07:21" pointsPerDay="113.4" remainderPoints="0" />
  11.     </rowset>
  12.   </result>
  13.   <cachedUntil>2011-07-28 19:07:24</cachedUntil>
  14. </eveapi>

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

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

Имя Тип данных Описание
agentID int Идентификатор агента, с которым проводятся исследования. Имя агента можно узнать вызовом функции /eve/CharacterName.xml.aspx, указав данный идентификатор в качестве параметра. Так же, информация об агентах хранится в таблице agtAgents дампа базы данных EVE Online.
skillTypeID int Идентификатор навыка, по тематике которого ведутся исследования. Это не typeID датакоры, на которую вы можете обменять очки исследований.
researchStartDate dateTime Дата и время начала исследования.
pointsPerDay decimal Количество очков, начисляемое за один день исследований.
remainderPoints float В данном поле указывается не текущее количество доступных RP, а информация, которую невозможно вычислить самостоятельно. Если вы ни разу ещё (с момента, указанного в researchStartDate) не покупали датакоры, а так же не сделали ни одной миссии, предлагаемой агентом ежедневно, в этом поле содержится значение "0". Когда вы делаете вышеописанную миссию, количество очков, полученное за её выполнение, прибавляется к значению данного поля. Если вы покупаете датакоры, то количество очков, затраченное на покупку, вычитается из значения данного поля. Так, например, если вы периодически наведываетесь к агенту за датакорами, в этом поле скорее всего содержится отрицательное значение. Формула, с помощью которой рассчитывается количество доступных очков, описана немного ниже – в разделе с дополнительной информацией.

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

Формула для получения текущего количества доступных очков выглядит следующим образом:

текущее_количество = remainderPoints + pointsPerDay × количество_полных_дней_с_момента_researchStartDate

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

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

Запрос файла https://api.eveonline.com/char/Research.xml.aspx
vCode
keyID
characterID
Категория: Разработчикам | Добавил: Heritor (29 Июль 2011) | Автор: Heritor Skoliya E W
Просмотров: 1329 | Рейтинг: 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.