Здесь представлено описание мира Повелителей. Обращаем Ваше внимание, что мир может изменяться и данное описание может не соответствовать действительности. Если Вы заметили несоответствие или знаете, как улучшить описание, оставьте комментарий в соответствующем разделе.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

 16. API

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 - не принимаются.

К содержанию ^   Комментарии (50)

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19