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

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

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

Кэширование

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

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

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

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

Данный XML-файл приведён в сокращённом виде.

  1. <?xml version='1.0' encoding='UTF-8'?>
  2. <eveapi version="2">
  3.   <currentTime>2011-07-23 12:08:25</currentTime>
  4.   <result>
  5.     <rowset name="transactions" key="refID" columns="date, refID, refTypeID, ownerName1, ownerID1, ownerName2, ownerID2, argName1, argID1, amount, balance, reason, taxReceiverID, taxAmount">
  6.       <row date="2011-07-23 11:55:00" refID="4645984658" refTypeID="42" ownerName1="Heritor Skoliya" ownerID1="1770043567" ownerName2="" ownerID2="0" argName1="" argID1="0" amount="-467112.96" balance="576223856.23" reason="" taxReceiverID="" taxAmount="" />
  7.       <row date="2011-07-23 11:53:00" refID="4645979015" refTypeID="54" ownerName1="Heritor Skoliya" ownerID1="1770043567" ownerName2="Secure Commerce Commission" ownerID2="1000132" argName1="" argID1="0" amount="-178878.28" balance="576690969.19" reason="" taxReceiverID="" taxAmount="" />
  8.       <row date="2011-07-23 11:53:00" refID="4645979014" refTypeID="2" ownerName1="vortak" ownerID1="437030268" ownerName2="Heritor Skoliya" ownerID2="1770043567" argName1="2233107600" argID1="0" amount="35775656.80" balance="576869847.47" reason="" taxReceiverID="" taxAmount="" />
  9.       ...
  10.       <row date="2011-07-23 11:52:00" refID="4645977562" refTypeID="57" ownerName1="Heritor Skoliya" ownerID1="1770043567" ownerName2="Lai Dai Corporation" ownerID2="1000020" argName1="113274011" argID1="0" amount="-10168.59" balance="541124696.45" reason="" taxReceiverID="" taxAmount="" />
  11.       <row date="2011-07-23 11:50:00" refID="4645972668" refTypeID="42" ownerName1="Heritor Skoliya" ownerID1="1770043567" ownerName2="" ownerID2="0" argName1="" argID1="0" amount="-100366.90" balance="541134865.04" reason="" taxReceiverID="" taxAmount="" />
  12.       <row date="2011-07-23 11:49:00" refID="4645970321" refTypeID="46" ownerName1="Heritor Skoliya" ownerID1="1770043567" ownerName2="Secure Commerce Commission" ownerID2="1000132" argName1="EVE System" argID1="1" amount="-100.00" balance="541235231.94" reason="" taxReceiverID="" taxAmount="" />
  13.       <row date="2011-07-23 11:49:00" refID="4645969815" refTypeID="42" ownerName1="Heritor Skoliya" ownerID1="1770043567" ownerName2="" ownerID2="0" argName1="" argID1="0" amount="-96723446.40" balance="541235331.94" reason="" taxReceiverID="" taxAmount="" />
  14.       <row date="2011-07-23 11:48:00" refID="4645968637" refTypeID="46" ownerName1="Heritor Skoliya" ownerID1="1770043567" ownerName2="Secure Commerce Commission" ownerID2="1000132" argName1="EVE System" argID1="1" amount="-3680.12" balance="637958778.34" reason="" taxReceiverID="" taxAmount="" />
  15.       <row date="2011-07-23 11:44:00" refID="4645961108" refTypeID="46" ownerName1="Heritor Skoliya" ownerID1="1770043567" ownerName2="Secure Commerce Commission" ownerID2="1000132" argName1="EVE System" argID1="1" amount="-151.86" balance="637994224.07" reason="" taxReceiverID="" taxAmount="" />
  16.     </rowset>
  17.   </result>
  18.   <cachedUntil>2011-07-23 12:35:26</cachedUntil>
  19. </eveapi>

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

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

Имя Тип данных Описание
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 на данное значение приводится после данной таблицы (подраздел "Аргументы").
taxReceiverID int В случае, если данная операция облагается налогом, в данном поле указывается идентификатор корпорации, которая получит сумму, равную taxAmount.
taxAmount decimal В случае, если данная операция облагается налогом, в данном поле указывается сумма, которая будет направлена в пользу корпорации, идентификатор которой указан в поле taxReceiverID.

Аргументы

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

refTypeID argName1 argID1 reason Комментарий
1 Название станции Идентификатор станции Описывается станция, на которой имела место быть прямая торговля между персонажами.
2 Идентификатор транзакции 0 argName1 принимает значение соответствующего transactionID, которое возвращается среди прочих параметров при вызове функции /char/WalletTransactions.xml.aspx.
10 0 "DESC: " + введённый пользователем текст При прямом переводе средств от одного игрока к другому можно указывать описание такого перевода. Это описание хранится в поле reason.
19 Идентификатор типа корабля 0 При выплате игроку страховки за разрушенный корабль argName1 принимает значение соответствующее typeID (идентификатор типа корабля). Соответствие идентификатора названию можно узнать из таблицы invTypes дампа базы данных игры, либо из результата, возвращаемого API-функцией /eve/CharacterName.xml.aspx, которой в качестве параметра передаётся значение argName1.
56-62 Идентификатор задания 0 argName1 принимает значение соответствующего jobID, которое возвращается среди прочих параметров при вызове функции /char/IndustryJobs.xml.aspx.
85 Идентификатор солнечной системы идентификатор:количество
[,идентификатор:количество
[,...]]
argID1 принимает значение идентификатора солнечной системы, в которой игрок разрушал NPC-корабли. Этот идентификатор хранится в поле solarSystemID таблицы mapSolarSystems дампа базы данных игры. Строка reason состоит из списка разрушенных NPC-кораблей, который представлен в виде значений "идентификатор:количество", разделённых запятыми, где идентификатор – значение typeID для данного NPC, а количество – число разрушенных кораблей этого типа. Имя NPC можно узнать, если вызвать функцию /eve/CharacterName.xml.aspx, передав ей в качестве параметра значение "идентификатор". Если список занимает больше 60 символов он заканчивается символами ",...", что указывает на неполноту списка.

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

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

Механизм данной функции таков, что пользователь может получать данные по операциям за последний месяц. Если же количество таких операций больше 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/char/WalletJournal.xml.aspx
vCode
keyID
characterID
rowCount
fromID
Категория: Разработчикам | Добавил: Heritor (23 Июль 2011) | Автор: Heritor Skoliya E W
Просмотров: 1907 | Рейтинг: 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.