API EVE Online. /eve/CertificateTree.xml.aspx

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

Эта API-функция возвращает список сертификатов в игре. В состав данных входит информация о навыках и сертификатах, требуемых для получения данного сертификата.

Кэширование

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

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

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

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

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

  1. <?xml version='1.0' encoding='UTF-8'?>
  2. <eveapi version="2">
  3.   <currentTime>2011-07-20 16:45:00</currentTime>
  4.   <result>
  5.     <rowset name="categories" key="categoryID" columns="categoryID,categoryName">
  6.       <row categoryID="3" categoryName="Core">
  7.         <rowset name="classes" key="classID" columns="classID,className">
  8.           <row classID="2" className="Core Fitting">
  9.             <rowset name="certificates" key="certificateID" columns="certificateID,grade,corporationID,description">
  10.               <row certificateID="5" grade="1" corporationID="1000125" description="This certificate represents a basic level of competence in fitting ships. It certifies that the holder is able to use baseline modules which improve power and CPU capabilities such as Co-Processors, Power Diagnostic Systems and Reactor Control Units. This is the first step towards broadening your fitting options.">
  11.                 <rowset name="requiredSkills" key="typeID" columns="typeID,skillLevel">
  12.                   <row typeID="3413" level="3" />
  13.                   <row typeID="3424" level="2" />
  14.                   <row typeID="3426" level="3" />
  15.                   <row typeID="3432" level="1" />
  16.                 </rowset>
  17.                 <rowset name="requiredCertificates" key="certificateID" columns="certificateID,grade" />
  18.               </row>
  19.               <row certificateID="6" grade="2" corporationID="1000125" description="This certificate represents a standard level of competence in fitting ships. It certifies that the holder is able to use Micro Auxiliary Power Cores and many Tech 2 fitting modules. The holder knows that MAPCs are the best way to increase power output on Frigate-class ships. This provides you with a broad range of fitting options">
  20.                 <rowset name="requiredSkills" key="typeID" columns="typeID,skillLevel">
  21.                   <row typeID="3318" level="4" />
  22.                   <row typeID="3413" level="5" />
  23.                   <row typeID="3418" level="4" />
  24.                   <row typeID="3426" level="5" />
  25.                   <row typeID="3432" level="4" />
  26.                 </rowset>
  27.                 <rowset name="requiredCertificates" key="certificateID" columns="certificateID,grade">
  28.                   <row certificateID="5" grade="1" />
  29.                 </rowset>
  30.               </row>
  31.               <row certificateID="7" grade="3" corporationID="1000125" description="This certificate represents an improved level of competence in fitting ships. It certifies that the holder is able to use all available fitting modules. At this stage you have an extremely wide range of fitting options available.">
  32.                 <rowset name="requiredSkills" key="typeID" columns="typeID,skillLevel">
  33.                   <row typeID="3424" level="5" />
  34.                   <row typeID="3432" level="5" />
  35.                   <row typeID="11207" level="4" />
  36.                 </rowset>
  37.                 <rowset name="requiredCertificates" key="certificateID" columns="certificateID,grade">
  38.                   <row certificateID="6" grade="1" />
  39.                 </rowset>
  40.               </row>
  41.               <row certificateID="8" grade="5" corporationID="1000125" description="This certificate represents an elite level of competence in fitting ships. It certifies that the holder has maximized their fitting capabilities. You have now reached the point where you should be able to use any valid module configuration without fitting issues.">
  42.                 <rowset name="requiredSkills" key="typeID" columns="typeID,skillLevel">
  43.                   <row typeID="11207" level="5" />
  44.                 </rowset>
  45.                 <rowset name="requiredCertificates" key="certificateID" columns="certificateID,grade">
  46.                   <row certificateID="7" grade="1" />
  47.                 </rowset>
  48.               </row>
  49.             </rowset>
  50.           </row>
  51.         </rowset>
  52.       </row>
  53.     </rowset>
  54.   </result>
  55.   <cachedUntil>2011-07-20 16:45:00</cachedUntil>
  56. </eveapi>

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

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

Этот набор строк можно понимать, как группу классов сертификатов, объединённых по смыслу. Например: классы группы "Gunnery" или "Business and Industry", или "Planetary Interaction" и т.п.

Имя Тип данных Описание
categoryID int Идентификатор категории.
categoryName string Название категории.

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

Здесь название класса является названием сертификата в привычном для пользователя смысле. Хотя, если смотреть со стороны системы, классы – это группа сертификатов описывающих одну и ту же сущность, но использующая в качестве критерия качественный параметр. Этим качественным параметром является уровень (grade) сертификата (описывается в группе строк "certificates"). Однако, у разных классов разное количество уровней, в отличие от навыков. Например, grade для Core Navigation может принимать значения: Basic, Standard, Improved и Elite, а для Core Targeting доступны только: Basic, Standard и Elite.

Имя Тип данных Описание
classID int Идентификатор класса.
className string Название класса.

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

Этот набор строк описывает конкретный сертификат, с указанием его уровня.

Имя Тип данных Описание
certificateID int Идентификатор сертификата.
grade int Уровень сертификата. Соответствия значений тому, что видит пользователь в игре, следующие:
  • 1 – Basic
  • 2 – Standard
  • 3 – Improved
  • 5 – Elite
corporationID int Идентификатор корпорации, выдающей данный сертификат. Название корпорации можно узнать, вызвав функцию /eve/CharacterID.xml.aspx, передав ей в качестве параметра данный идентификатор.
description string Описание сертификата.

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

Данный набор строк описывает то, какие навыки и до каких уровней должны быть изучены, чтобы появилась возможность получить описываемый сертификат.

Имя Тип данных Описание
typeID int Идентификатор требуемого навыка. Название навыка можно узнать, если сопоставить этот идентификатор с typeID набора строк "skills" при вызове API-функции /eve/SkillTree.xml.aspx.
skillLevel int Уровень требуемого навыка.

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

Описание того, какими сертификатами нужно обладать, чтобы появилась возможность получить этот сертификат.

Имя Тип данных Описание
certificateID int Идентификатор сертификата.
grade int Требуемый уровень. На данный момент, этот параметр всегда принимает значение, равное "1". Ниже приводится дополнительная информация о том, как обстоят дела с этим параметром.

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

Внутри набора строк "requiredCertificates" переменная grade всегда получает значение, равное единице, даже если сертификат с соответствующим значением certificateID показывает совсем другое. В данном случае лучше использовать значение grade из набора строк "certificates". Говорят, что текущая ситуация – баг. Вообще, сейчас похоже на то, что grade из набора строк "requiredCertificates" представляет из себя флаг: "Дескать, данный сертификат должен быть отмечен изученным."

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

Вы можете самостоятельно получить данные, используя следующую ссылку: https://api.eveonline.com/eve/CertificateTree.xml.aspx

Категория: Разработчикам | Добавил: Heritor (20 Июль 2011) | Автор: Heritor Skoliya E W
Просмотров: 1560 | Рейтинг: 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.