API расшифровывается как интерфейс программирования приложений (англ. application programming interface). В Маоли API — это набор готовых функций и параметров, предоставляемых игрой для использования программистами кланов в своих игровых сервисах.
Для чего нужен API
API в Маоли сделан для развития клан-сайтов.
Пример 1. Благодаря API программистам кланов для создания сервисов поиска товаров на аукционах и биржах теперь не нужно делать ботов, чтобы постоянно "сканировать" страницы аукционов и бирж. Интерфейс API позволяет выводить всю нужную информацию на специальной страничке, которая не создаёт нагрузки на сервер игры, а программистам кланов даёт возможность получать нужную информацию максимально быстро.
Пример 2. Теперь всю информацию о персонаже программисты кланов получают в удобно для них виде - не нужно постоянно обновлять страницы с множеством графического материала, создавая не нужный трафик и нагрузку на сервер игры. Благодаря этому, можно создать быстрый локатор врагов или вообще создать сервис, позволяющий вывести список Повелителей мужского пола 7-го уровня, которые находятся в Сером мире в одиночестве без поддержки сокланов 8-го уровня.
Вызов функции API
Для корректного отображения выводимой информации через API необходимо использовать браузер Mozilla Firefox. В других браузерах информация отображается некорректно.
Обновлять страницу API можно не чаще, чем 1 раз в 1 минуту.
Вызов функции API происходит по запросу:
dgame.ru/api.php?selfid=persclanid&key=perskey&type=request type&requestparams
где:
persclanid - ID персонажа или клана, который осуществляет запрос.
perskey - персональный ключ (для персонажей отображается во вкладке Настройки/API, а для кланов виден только для Главы клана на внутренней странице клана).
requesttype - тип запроса. Поддерживаются следующие типы запросов: person, auction, exchange, thingtype, thingtypeset, effecttype, discipletype, clans, altars.
requestparams - параметры, специфичные для каждого типа запроса.
Примеры конкретных запросов можно увидеть ниже.
Типы запросов
person - получение информации о персонаже.
Данный тип запроса поддерживает следующий параметры:
id=userid - ID персонажа, информацию о котором нужно получить.
При этом, если <userid> добавил <selfid> в доверенный список или <userid>=<selfid>, то информация будет более полная. Добавить себя в доверенный список другим пользователям можно во вкладке Настройки/API.
Важно:
1. Если на Повелителе имеется эффект "Синий дым", то информация о персонаже не выводится.
2. Точная локация местоположения Повелителя выводится только в том случае, если разрешен доступ к личным данным. Если не разрешен доступ к личным данным, то выводится id той локации, которая в данный момент отображается на странице информации о персонаже.
Атрибуты:
leader: 1-Повелитель, 0-Последователь
Пример запроса:
dgame.ru/api.php?selfid=101537&key=abcdef1234567890&type=pe rson&id=112166 - Вывести информацию о Повелителе
Veterok [8] (для ввода в строку браузера, уберите лишний пробел в ссылке).
auction - получение информации о выставленных лотах на аукционе (информация обновляется каждые 10 минут).
Данный тип запроса поддерживает следующие параметры:
world=1,2, где 2 - Элгот, 1 - Денеи.
department=1, 2, 6, 7, где 1 - вещи, 2 - последователи, 6 - эликсиры, 7 - свитки.
Атрибуты:
exp: процент опыта на последователе
tattoo: ID Т.А.Т.У. на последователе
Пример запроса:
dgame.ru/api.php?selfid=101537&key=abcdef1234567890&type=au ction&world=1&department=2 - Вывести информацию о последователях, выставленных на аукцион в Элготе.
exchange - получение информации о выставленных лотах на бирже (информация обновляется каждые 10 минут).
Данный тип запроса поддерживает следующие параметры:
world=1,2, где 1 - Элгот, 2 - Денеи.
Пример запроса:
dgame.ru/api.php?selfid=101537&key=abcdef1234567890&type=ex change&world=2 - Вывести информацию обо всех лотах на бирже в Денеи.
clans - получение всей информации обо всех кланах, которая отображается на страницах рейтинга кланов.
Данный тип запроса не поддерживает дополнительные параметры.
При выводе информации о кланах выводится также и состав этих кланов в виде ID Повелителей.
Пример запроса:
dgame.ru/api.php?selfid=101537&key=abcdef1234567890&type=cl ans - Вывести информацию обо всех кланах Маоли.
altars - получение информации о статусе алтарей за предыдущий день (какой мир победил)
Данный тип запроса не поддерживает дополнительные параметры.
Пример запроса:
dgame.ru/api.php?selfid=101537&key=abcdef1234567890&type=al tars - Вывести информацию о статусе алтарей за вчерашний день.
Описание выводимых параметров по состоянию на 1 марта:
<altar level="4"> - уровень алтаря (4,5,6,7,8 уровни)
<roomid>67239936</roomid> - ID локации, на которой расположен алтарь
<win w1="1" w2="3"/> - число побед у Элгота и у Денеи (w1 - число побед у Элгота, w2 - число побед у Денеи)
<world>2</world> - ID мира, победившего на алтаре (0(?) - ничья, 1 - Элгот, 2 -Денеи)
<time>1298926800</time> - время в формате Unixtime. К времени GMT необходимо прибавлять 3 часа, чтобы получить наше время. После преобразования данного времени получится 01 2011 00:00:00.
thingtype - получение всей информации о типах вещей.
Данный тип запроса поддерживает следующие параметры:
id=<idlist>, где <idlist> - список id вещей через запятую, информацию о которых надо получить.
Пример запроса:
dgame.ru/api.php?selfid=101537&key=abcdef1234567890&type=th ingtype&id=560,436 - Вывести информацию о вещах
Гордость Мастера и
Призыв лечинок 4 ур.
effecttype - получение информации о типах эффектов.
Данный тип запроса поддерживает следующие параметры:
id=<idlist>, где <idlist> - список id эффектов через запятую, информацию о которых надо получить.
Пример запроса:
dgame.ru/api.php?selfid=101537&key=abcdef1234567890&type=ef fecttype&id=16384257,6559253 - Вывести информацию об эффекте
VIP и таланте
Барон Ласэлора.
discipletype - получение информации о типах последователей.
Данный тип запроса поддерживает следующие параметры:
id=<idlist>, где <idlist> - список id типов последователей через запятую, информацию о которых надо получить.
Пример запроса:
dgame.ru/api.php?selfid=101537&key=abcdef1234567890&type=di scipletype&id=598,883,349 - Вывести информацию о последователе
Боевой Шаман и монстрах
Горг и
Обожравшийся.
thingtypeset - получение информации о типах комплектов вещей.
Данный тип запроса поддерживает следующие параметры:
id=<idlist>, где <idlist> - список id типов комплектов вещей через запятую, информацию о которых надо получить.
Пример запроса:
dgame.ru/api.php?selfid=101537&key=abcdef1234567890&type=th ingtypeset&id=503 - Вывести информацию о комплекте вещей
Комплект Авантюриста.
О других типах запросов
Если вам нужна информация другого характера, то вы можете высказать здесь свое пожелание. При этом, надо четко описывать что вам нужно. Например, если вам нужна информация о ежедневных турнирах, то перечислите подробно всю информацию, которую вы хотите увидеть. Пожелания от игроков, которые не собираются создавать сервисы с помощью API - не принимаются.