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

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

Данная функция возвращает журнал с историей операций всех дивизионов кошелька корпорации.

Кэширование

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

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

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

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

  1. <?xml version='1.0' encoding='UTF-8'?>
  2. <eveapi version="2">
  3.   <currentTime>2011-07-28 16:19:45</currentTime>
  4.   <result>
  5.     <rowset name="entries" key="refID" columns="date, refID, refTypeID, ownerName1, ownerID1, ownerName2, ownerID2, argName1, argID1, amount, balance, reason">
  6.       <row date="2011-07-28 16:10:00" refID="4669598914" refTypeID="42" ownerName1="Heritor Skoliya" ownerID1="1770043567" ownerName2="" ownerID2="0" argName1="" argID1="0" amount="-28900.00" balance="24995176.77" reason="" />
  7.       <row date="2011-07-28 16:10:00" refID="4669597827" refTypeID="37" ownerName1="Skoliyan Industry" ownerID1="945792655" ownerName2="Heritor Skoliya" ownerID2="1770043567" argName1="Heritor Skoliya" argID1="1770043567" amount="-1000.00" balance="25024076.77" reason="DESC: moneyback&#xA;" />
  8.       <row date="2011-07-28 16:09:00" refID="4669595798" refTypeID="10" ownerName1="Heritor Skoliya" ownerID1="1770043567" ownerName2="Skoliyan Industry" ownerID2="945792655" argName1="" argID1="0" amount="1000.00" balance="25025076.77" reason="DESC: API testing&#xA;" />
  9.     </rowset>
  10.   </result>
  11.   <cachedUntil>2011-07-28 16:46:45</cachedUntil>
  12. </eveapi>

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

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

Имя Тип данных Описание
date dateTime Дата и время операции.
refID bigint Уникальный идентификатор операции. Его можно использовать для навигации по журналу, указывая при вызове функции самое младшее значение refID в качестве параметра fromID. Подробнее процесс навигации по журналу описан ниже – в разделе с дополнительной информацией.
refTypeID int Идентифиатор типа операции. Список типов операций можно получить вызовом функции /eve/RefTypes.xml.aspx.
ownerName1 string Имя стороны (первой стороны), к балансу которой прибавляется сумма, указанная в поле amount (важно обратить внимание, что отрицательное значение amount в итоге минусует баланс, так как плюс и минус дают минус – обычная математика). Первой стороной выступает инициатор операции.
ownerID1 int Идентификатор первой стороны.
ownerName2 string Имя второй стороны. От баланса данной стороны указанная сумма отнимается (а отрицательное значение amount в итоге плюсует баланс второй стороны, так как минус и минус дают плюс ).
ownerID2 int Идентификатор второй стороны.
argName1 Не определён Значение данного параметра зависит от refTypeID. Неполный список моментов влияния refTypeID на данное значение приводится после данной таблицы (подраздел "Аргументы").
argID1 int Значение данного параметра зависит от refTypeID. Неполный список моментов влияния refTypeID на данное значение приводится после данной таблицы (подраздел "Аргументы").
amount decimal Сумма операции.
balance decimal Баланс кошелька после осуществления операции.
reason string Значение данного параметра зависит от refTypeID. Неполный список моментов влияния refTypeID на данное значение приводится после данной таблицы (подраздел "Аргументы").

Аргументы

В следующей таблице указываются некоторые моменты зависимости от refTypeID смысла и значений полей argName1, argID1 и reason:

refTypeID argName1 argID1 reason Комментарий
10 0 "DESC: " + введённый пользователем текст При прямом переводе средств можно указывать описание такого перевода. Это описание хранится в поле reason.
37 Имя персонажа Идентификатор персонажа "DESC: " + введённый пользователем текст При прямом переводе средств из кошелька корпорации в кошелёк игрока можно указывать описание такого перевода. Это описание хранится в поле reason, а поля argName1 и argID1 хранят имя и идентификатор этого персонажа.

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

Навигация по журналу

Механизм данной функции таков, что пользователь может получать данные по операциям за последний месяц. Если же количество таких операций больше 2560 (это максимальное количество строк, которое может вернуть функция за один вызов), появляется возможность "листать" журнал, указывая функции в качестве параметра fromID наименьшее значение refID из списка, полученного текущим вызовом. В этом случае будет возвращён список, в котором отражены операции до этого refID. Однако, стоит обратить внимание, что возвращаемые функцией строки предварительно не сортируются на стороне API-сервера. Вполне может получиться так, что операция с наименьшим refID будет находиться в середине списка операций. Поэтому, чтобы узнать наименьший refID, нужно осуществлять сортировку полученных записей самостоятельно.

Автоматизированно получить все записи за последний месяц можно, если повторять запрос к API-серверу с указанием в качестве fromID минимального значения refID, полученного в текущем запросе, при этом указывая для rowCount значение 2560 (это поможет снизить количество запросов к серверу, что, в свою очередь, снизит для вас риск быть заблокированным по IP-адресу со стороны балансировщика нагрузки API-сервера). Если количество строк, которое вернула функция, меньше заданного rowCount или возвращается нулевое количество строк, значит конец журнала достигнут.

Ссылки

Данная функция упоминается в темах "refID in WalletJournal.xml.aspx", "API Patch notes for Incursion 1.1.2" и "API Patch notes for Incursion 1.4" официального форума игры EVE Online.

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

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

Запрос файла https://api.eveonline.com/corp/WalletJournal.xml.aspx
vCode
keyID
rowCount
fromID
Категория: Разработчикам | Добавил: Heritor (28 Июль 2011) | Автор: Heritor Skoliya E W
Просмотров: 2011 | Комментарии: 2 | Рейтинг: 0.0/0
Всего комментариев: 2
1 Klaima   (27 Январь 2012 17:02)
Подскажите пожалуйста, как выполнить запрос на получение данных по журналу, в виде 1 строки содержащей все необходимые данные (код, ключ,и тд) , которую можно вставить в браузер и получить файл с данными (xmls). Имеется ввиду, формат https://api.eveonline.com ... и что записать дальше?

2 Heritor   (27 Январь 2012 17:49)
1. В самом общем случае:
https://api.eveonline.com/corp/WalletJournal.xml.aspx?keyId=0000&vCode=aaa

где 0000 - идентификатор ключа, а "aaa" - код верификации

2. С регуляцией количества выводимых строк:
https://api.eveonline.com/corp/WalletJournal.xml.aspx?keyId=0000&vCode=aaa&rowCount=100

где 100 - количество выводимых строк

3. "Листание":
https://api.eveonline.com/corp/WalletJournal.xml.aspx?keyId=0000&vCode=aaa&rowCount=100&fromID=123456

где 123456 - это значение refID из результатов работы запроса 1 или 2.

Добавлять комментарии могут только зарегистрированные пользователи.
[ Регистрация | Вход ]
»Рубрики«
Новичкам [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.