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

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

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

Кэширование

Функция использует M-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>2010-10-05 20:28:55</currentTime>
  4.   <result>
  5.     <factionID>500001</factionID>
  6.     <factionName>Caldari State</factionName>
  7.     <enlisted>2008-06-10 22:10:00</enlisted>
  8.     <currentRank>4</currentRank>
  9.     <highestRank>4</highestRank>
  10.     <killsYesterday>0</killsYesterday>
  11.     <killsLastWeek>0</killsLastWeek>
  12.     <killsTotal>0</killsTotal>
  13.     <victoryPointsYesterday>0</victoryPointsYesterday>
  14.     <victoryPointsLastWeek>0</victoryPointsLastWeek>
  15.     <victoryPointsTotal>0</victoryPointsTotal>
  16.   </result>
  17.   <cachedUntil>2010-10-06 19:28:55</cachedUntil>
  18. </eveapi>

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

Поля группы "result"

Имя Тип данных Описание
factionID int Идентификатор фракции, от имени которой выступает пилот.
factionName string Название данной фракции.
enlisted dateTime Дата вступления во фракционные войска.
currentRank int Текущий ранг пользователя. Подробнее о рангах можно узнать на сайте EVELOPEDIA. Там же есть табели о рангах для калдари, минматар, амарров и галлентов.
highestRank int Максимальный ранг, достигнутый персонажем.
killsYesterday int Количество разрушенных кораблей за предыдущий день.
killsLastWeek int Количество разрушенных кораблей за последнюю неделю.
killsTotal int Общее количество разрушенных кораблей.
victoryPointsYesterday int Количество победных очков за предыдущий день.
victoryPointsLastWeek int Количество победных очков за последнюю неделю.
victoryPointsTotal int Общее количество победных очков.

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

Данная функция упоминается в девблоге Empyrean Age and The EVE API

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

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

  1. <?xml version='1.0' encoding='UTF-8'?>
  2. <eveapi version="2">
  3.   <currentTime>2011-07-23 07:55:30</currentTime>
  4.   <error code="124">Character not enlisted in Factional Warfare.</error>
  5.   <cachedUntil>2011-07-23 08:00:30</cachedUntil>
  6. </eveapi>

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

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

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