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

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

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

Кэширование

Функция использует M-Short-кэширование. Время кэширования составляет 60 минут, но данные вычисляются один раз в сутки – во время даунтайма.

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

Имя Тип данных Обязательность указания Описание
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="2">
  3.   <currentTime>2010-12-29 19:29:44</currentTime>
  4.   <result>
  5.     <factionID>500001</factionID>
  6.     <factionName>Caldari State</factionName>
  7.     <enlisted>2010-5-13 19:29:44</enlisted>
  8.     <pilots>2</pilots>
  9.     <killsYesterday>0</killsYesterday>
  10.     <killsLastWeek>0</killsLastWeek>
  11.     <killsTotal>0</killsTotal>
  12.     <victoryPointsYesterday>0</victoryPointsYesterday>
  13.     <victoryPointsLastWeek>0</victoryPointsLastWeek>
  14.     <victoryPointsTotal>0</victoryPointsTotal>
  15.    </result>
  16.   <cachedUntil>2010-12-29 20:29:44</cachedUntil>
  17. </eveapi>

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

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

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

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

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

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

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

  1. <?xml version='1.0' encoding='UTF-8'?>
  2. <eveapi version="2">
  3.   <currentTime>2011-07-23 09:54:31</currentTime>
  4.   <error code="125">Corporation not enlisted in Factional Warfare.</error>
  5.   <cachedUntil>2011-07-23 09:59:31</cachedUntil>
  6. </eveapi>

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

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

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