Библиотека знаний

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

3.3. Чат
11.1. NPC
12.1.1.1. Ремонт
12.1.2.1. Аукцион
12.1.2.2. Биржа
12.1.3. Арена
12.1.5. Храм
12.1.6. Ворота
12.2.1. Шахты
12.2.2. Алтари
12.2.3. Портал
12.2.4. Пасека
12.2.5. Фермы
14.1. Улей
16. API


К предыдущей главе 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 К следующей главе



Яндекс.Метрика

Copyright © 2008-2013 dgame.ru. Версия [email protected]@%.Все права защищены. Никакая часть этого сайта и размещённых на нём материалов не может быть использована в какой-либо форме, включая печатную и электронную без письменного согласия авторов. E-mail:[email protected]