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

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

Данная функция возвращает список транзакций в маркете. В состав транзакции входит цена, количество товара, клиент и т.д.

Кэширование

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

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

Имя Тип данных Обязательность указания Описание
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 Необязательный параметр Количество строк, выводимое на одной "странице". По умолчанию выводятся 1000 записей. Может принимать значения от 1 до 2560.

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

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

  1. <?xml version='1.0' encoding='UTF-8'?>
  2. <eveapi version="2">
  3.   <currentTime>2011-07-24 16:47:32</currentTime>
  4.   <result>
  5.     <rowset name="transactions" key="transactionID" columns="transactionDateTime, transactionID, quantity, typeName, typeID, price, clientID, clientName, stationID, stationName, transactionType, transactionFor, journalTransactionID">
  6.       <row transactionDateTime="2011-07-24 14:54:34" transactionID="2234421349" quantity="1" typeName="Mexallon" typeID="36" price="29.02" clientID="90499755" clientName="Pick en Tilavine" stationID="60003760" stationName="Jita IV - Moon 4 - Caldari Navy Assembly Plant" transactionType="buy" transactionFor="personal" journalTransactionID="4651611028" />
  7.       <row transactionDateTime="2011-07-24 14:44:01" transactionID="2234410630" quantity="24606" typeName="Zydrine" typeID="39" price="740.01" clientID="993324428" clientName="Dax Gondor" stationID="60003760" stationName="Jita IV - Moon 4 - Caldari Navy Assembly Plant" transactionType="sell" transactionFor="personal" journalTransactionID="4651564138" />
  8.       <row transactionDateTime="2011-07-24 14:37:39" transactionID="2234403641" quantity="700000" typeName="Mexallon" typeID="36" price="28.99" clientID="90916399" clientName="Groucho M" stationID="60003760" stationName="Jita IV - Moon 4 - Caldari Navy Assembly Plant" transactionType="buy" transactionFor="personal" journalTransactionID="4651534340" />
  9.       <row transactionDateTime="2011-07-24 14:30:30" transactionID="2234396458" quantity="51" typeName="Morphite" typeID="11399" price="3416.18" clientID="582273089" clientName="Xelrazh" stationID="60003760" stationName="Jita IV - Moon 4 - Caldari Navy Assembly Plant" transactionType="buy" transactionFor="personal" journalTransactionID="4651502060" />
  10.       ...
  11.       <row transactionDateTime="2011-07-24 16:40:47" transactionID="2234539306" quantity="47270" typeName="Pyroxeres" typeID="1224" price="30.86" clientID="1650639063" clientName="JohnSheridan" stationID="60003934" stationName="Poinen V - Moon 12 - Internal Security Assembly Plant" transactionType="buy" transactionFor="personal" journalTransactionID="4652118412" />
  12.       <row transactionDateTime="2011-07-24 16:40:57" transactionID="2234539527" quantity="43575" typeName="Solid Pyroxeres" typeID="17459" price="32.41" clientID="1650639063" clientName="JohnSheridan" stationID="60003934" stationName="Poinen V - Moon 12 - Internal Security Assembly Plant" transactionType="buy" transactionFor="personal" journalTransactionID="4652119226" />
  13.       <row transactionDateTime="2011-07-24 16:41:11" transactionID="2234539781" quantity="22424" typeName="Viscous Pyroxeres" typeID="17460" price="33.06" clientID="1650639063" clientName="JohnSheridan" stationID="60003934" stationName="Poinen V - Moon 12 - Internal Security Assembly Plant" transactionType="buy" transactionFor="personal" journalTransactionID="4652120209" />
  14.       <row transactionDateTime="2011-07-24 16:41:20" transactionID="2234539976" quantity="59945" typeName="Concentrated Veldspar" typeID="17470" price="10.30" clientID="1650639063" clientName="JohnSheridan" stationID="60003934" stationName="Poinen V - Moon 12 - Internal Security Assembly Plant" transactionType="buy" transactionFor="personal" journalTransactionID="4652120964" />
  15.       <row transactionDateTime="2011-07-24 16:41:34" transactionID="2234540253" quantity="53" typeName="Veldspar" typeID="1230" price="8.63" clientID="91045241" clientName="KORION Makanen" stationID="60015027" stationName="Uitra VI - Moon 4 - State War Academy School" transactionType="buy" transactionFor="personal" journalTransactionID="4652122041" />
  16.       <row transactionDateTime="2011-07-24 16:42:29" transactionID="2234541408" quantity="6424" typeName="Tritanium" typeID="34" price="3.26" clientID="91045241" clientName="KORION Makanen" stationID="60015027" stationName="Uitra VI - Moon 4 - State War Academy School" transactionType="buy" transactionFor="personal" journalTransactionID="4652128265" />
  17.     </rowset>
  18.   </result>
  19.   <cachedUntil>2011-07-24 17:14:33</cachedUntil>
  20. </eveapi>

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

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

Имя Тип данных Описание
transactionDateTime dateTime Дата и время транзакции.
transactionID bigint Идентификатор транзакции. Его можно использовать для навигации по журналу, указывая при вызове функции самое младшее значение transactionID в качестве параметра fromID. Подробнее процесс навигации по журналу описан ниже – в разделе с дополнительной информацией.
quantity int Количество единиц товара, покупка/продажа которого подразумевается в данной транзакции.
typeName string Название товара.
typeID int Идентификатор товара.
price decimal Цена за одну единицу товара. Итоговую сумму можно получить, перемножив поля quantity и price.
clientID int Идентификатор клиента.
clientName string Имя клиента.
stationID bigint Идентификатор станции, на которой производилась транзакция.
stationName string Название станции, на которой производилась транзакция.
transactionType string Тип транзакции. Может принимать значения buy (когда вы что-то купили) и sell (если прóдали).
transactionFor string Принимает значение corporation если покупка/продажа осуществлялась с использованием корпоративного кошелька. Во всех остальных случаях равно personal.
journalTransactionID bigint Принимает значение соответствующей операции в кошельке персонажа. Значение равно refID, которое возвращается при вызове функции /char/WalletJournal.xml.aspx.

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

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

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

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

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

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

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