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

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

Вызов данной функции возвращает список определённого количества последних производственных заданий (включая те, которые были завершены, а продукты по ним получены).

Кэширование

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

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

Никакие дополнительные аргументы для вызова функции не используются.

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

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

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

  1. <?xml version='1.0' encoding='UTF-8'?>
  2. <eveapi version="2">
  3.   <currentTime>2011-07-24 18:38:04</currentTime>
  4.   <result>
  5.     <rowset name="jobs" key="jobID" columns="jobID, assemblyLineID, containerID, installedItemID, installedItemLocationID, installedItemQuantity, installedItemProductivityLevel, installedItemMaterialLevel, installedItemLicensedProductionRunsRemaining, outputLocationID, installerID, runs, licensedProductionRuns, installedInSolarSystemID, containerLocationID, materialMultiplier, charMaterialMultiplier, timeMultiplier, charTimeMultiplier, installedItemTypeID, outputTypeID, containerTypeID, installedItemCopy, completed, completedSuccessfully, installedItemFlag, outputFlag, activityID, completedStatus, installTime, beginProductionTime, endProductionTime, pauseProductionTime">
  6.       <row jobID="113360515" assemblyLineID="301934" containerID="60002281" installedItemID="1002811234741" installedItemLocationID="60002281" installedItemQuantity="1" installedItemProductivityLevel="0" installedItemMaterialLevel="260" installedItemLicensedProductionRunsRemaining="1500" outputLocationID="60002281" installerID="1770043567" runs="1" licensedProductionRuns="10" installedInSolarSystemID="30000168" containerLocationID="30000168" materialMultiplier="-4" charMaterialMultiplier="1" timeMultiplier="-4" charTimeMultiplier="1" installedItemTypeID="2455" outputTypeID="2457" containerTypeID="1529" installedItemCopy="1" completed="0" completedSuccessfully="0" installedItemFlag="4" outputFlag="4" activityID="8" completedStatus="0" installTime="2011-07-24 10:39:30" beginProductionTime="2011-07-26 02:54:35" endProductionTime="2011-07-26 04:54:35" pauseProductionTime="0001-01-01 00:00:00" />
  7.       <row jobID="113360500" assemblyLineID="301932" containerID="60002281" installedItemID="1002811234735" installedItemLocationID="60002281" installedItemQuantity="1" installedItemProductivityLevel="0" installedItemMaterialLevel="260" installedItemLicensedProductionRunsRemaining="1500" outputLocationID="60002281" installerID="1770043567" runs="1" licensedProductionRuns="10" installedInSolarSystemID="30000168" containerLocationID="30000168" materialMultiplier="-4" charMaterialMultiplier="1" timeMultiplier="-4" charTimeMultiplier="1" installedItemTypeID="2455" outputTypeID="2457" containerTypeID="1529" installedItemCopy="1" completed="0" completedSuccessfully="0" installedItemFlag="4" outputFlag="4" activityID="8" completedStatus="0" installTime="2011-07-24 10:39:19" beginProductionTime="2011-07-26 02:54:11" endProductionTime="2011-07-26 04:54:11" pauseProductionTime="0001-01-01 00:00:00" />
  8.       ...
  9.       <row jobID="113360483" assemblyLineID="301934" containerID="60002281" installedItemID="1002811233753" installedItemLocationID="60002281" installedItemQuantity="1" installedItemProductivityLevel="0" installedItemMaterialLevel="100" installedItemLicensedProductionRunsRemaining="1500" outputLocationID="60002281" installerID="1770043567" runs="1" licensedProductionRuns="10" installedInSolarSystemID="30000168" containerLocationID="30000168" materialMultiplier="-4" charMaterialMultiplier="1" timeMultiplier="-4" charTimeMultiplier="1" installedItemTypeID="2455" outputTypeID="2457" containerTypeID="1529" installedItemCopy="1" completed="0" completedSuccessfully="0" installedItemFlag="4" outputFlag="4" activityID="8" completedStatus="0" installTime="2011-07-24 10:39:10" beginProductionTime="2011-07-26 00:54:35" endProductionTime="2011-07-26 02:54:35" pauseProductionTime="0001-01-01 00:00:00" />
  10.       <row jobID="109885805" assemblyLineID="301922" containerID="60002281" installedItemID="1002347602844" installedItemLocationID="60002281" installedItemQuantity="1" installedItemProductivityLevel="360" installedItemMaterialLevel="0" installedItemLicensedProductionRunsRemaining="1500" outputLocationID="60002281" installerID="1770043567" runs="1" licensedProductionRuns="10" installedInSolarSystemID="30000168" containerLocationID="30000168" materialMultiplier="-4" charMaterialMultiplier="1" timeMultiplier="-4" charTimeMultiplier="1" installedItemTypeID="2455" outputTypeID="2457" containerTypeID="1529" installedItemCopy="1" completed="1" completedSuccessfully="0" installedItemFlag="4" outputFlag="4" activityID="8" completedStatus="0" installTime="2011-06-12 21:08:23" beginProductionTime="2011-06-12 21:08:20" endProductionTime="2011-06-12 23:08:20" pauseProductionTime="0001-01-01 00:00:00" />
  11.     </rowset>
  12.   </result>
  13.   <cachedUntil>2011-07-24 18:53:05</cachedUntil>
  14. </eveapi>

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

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

Имя Тип данных Описание
jobID int Уникальный идентификатор производственного задания.
assemblyLineID int Идентификатор производственной линии, используемой для данного задания. Идентификаторы линий неизменны для NPC-станций. Их список можно получить из таблицы ramAssemblyLines дампа базы данных EVE Online. Однако, производственные модули и мобильные лаборатории ПОСов обладаю неизменным идентификатором только то время, пока они заанчорены. Если такие модули отключить и перевезти в другое место, то при установке их производственные линии получат новые идентификаторы.
containerID int Если контейнером является ангар на станции, данное значение соответствует stationID таблицы staStations дампа базы данных. Если речь идёт о модуле ПОСа, то это itemID из списка имущества корпорации.
installedItemID bigint itemID блюринта.
installedItemLocationID int Идентификатор места, где было запущено задание. Станция, либо модуль ПОСа.
installedItemQuantity int Количество блюпринтов, участвующих в задании (всегда равно 1).
installedItemProductivityLevel int PL блюпринта на момент запуска задания.
installedItemMaterialLevel int ML блюпринта на момент запуска задания.
installedItemLicensedProductionRunsRemaining int Оставшееся количество возможных циклов использования для блюпринта (равно минус одному для оригиналов чертежей).
outputLocationID int Идентификатор места, куда будут выгружаться продукты после окончания задания.
installerID int Идентификатор персонажа, запустившего задание.
runs int Количество циклов использования блюпринта в данном задании (при копировании чертежей – количество копий, которое будет сделано).
licensedProductionRuns int Когда происходит копирование или инвентинг чертежа, данный параметр обозначает то, сколько возможных циклов использования будет доступно для полученного из результата задания чертежа.
installedInSolarSystemID int Идентификатор солнечной системы, в которой было запущено данное задание. Соответствие идентификатора названию можно узнать из таблицы mapSolarSystems дампа базы данных.
containerLocationID int Место, где находится контейнер, в который будут выгружены результаты работы задания. Принимает то же самое значение, что и installedInSolarSystemID.
materialMultiplier float Множитель количества материалов, требуемых для производства/исследования, характеризующий производственную линию (например, для модулей Rapid Assembly Arrays эта характеристики равна 1.2, что подразумевает использование на 20% больше материалов от указанного в характеристиках чертежа).
charMaterialMultiplier float Множитель количества материалов, который обеспечивают навыки и имплантаты пилота.
timeMultiplier float Множитель времени, требуемого для производства/исследования, характеризующий производственную линию.
charTimeMultiplier float Множитель времени, который обеспечивают навыки и имплантаты персонажа.
installedItemTypeID int Идентификатор чертежа, запущенного в задание. Соответствие идентификатора и названия можно найти в таблицах invTypes или invBlueprintTypes.
outputTypeID int Идентификатор продукта. Соответствие идентификатора и названия можно найти в таблицах invTypes или invBlueprintTypes.
containerTypeID int Идентификатор контейнера (станция, либо производственные модули). Соответствие идентификатора и названия можно найти в таблицах invTypes или invBlueprintTypes.
installedItemCopy bit Принимает значение 0, если в производственное задание запущен оригинал чертежа и 1, если запущена копия чертежа.
completed bit Принимает значение 1, если задание закончено и пользователь его выгрузил (кнопка "deliver" в окне со списком заданий клиента игры).
completedSuccessfully bit По наблюдениям, всегда принимает значение 0.
installedItemFlag int Флаг, указывающий то, откуда был взят чертёж для запуска в производственное задание. Соответствие идентификатора и названия можно найти в таблице invFlags дампа базы данных игры.
outputFlag int Флаг, указывающий то, куда будет помещён продукт после его выгрузки из задания. Соответствие идентификатора и названия можно найти в таблице invFlags дампа базы данных игры.
activityID int Идентификатор типа производственного задания. Соответствие идентификатора и названия можно найти в таблице ramActivities дампа базы данных игры.
completedStatus int По наблюдениям, имеет смысл только в случае, когда параметр completed равен 1. Может принимать следующие значения:
  • 1 – delivered
  • 2 – aborted
  • 3 – GM aborted
  • 4 – inflight unanchored
  • 5 – destroyed
  • 0 – failed
installTime dateTime Дата установки задания в очередь на производственную линию.
beginProductionTime dateTime Дата, когда начнётся обработка задания.
endProductionTime dateTime Дата окончания обработки задания производственной линией.
pauseProductionTime dateTime Обычное значение – 0001-01-01 00:00:00. Если задание запущено на одном из модулей ПОС, а этот модуль во время обработки задания ушёл в оффлайн, то показывается дата, когда модуль ушёл в оффлайн.

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

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

Вызов функции без параметров возвращает ошибку:

  1. <?xml version='1.0' encoding='UTF-8'?>
  2. <eveapi version="2">
  3.   <currentTime>2011-09-08 18:31:11</currentTime>
  4.   <error code="106">Must provide userID or keyID parameter for authentication.</error>
  5.   <cachedUntil>2011-09-08 18:31:11</cachedUntil>
  6. </eveapi>

Вызов функции с использованием неподходящего ключа возвращает ошибку:

  1. <?xml version='1.0' encoding='UTF-8'?>
  2. <eveapi version="2">
  3.   <currentTime>2011-09-08 18:24:50</currentTime>
  4.   <error code="221">Illegal page request! Please verify the access granted by the key you are using!</error>
  5.   <cachedUntil>2011-09-08 18:24:50</cachedUntil>
  6. </eveapi>

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

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

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