API интерфейс

Интерфейс позволяет получать данные в формате XML о персонажах и организациях онлайн игры Дозоры

Запросы:

1. Проверка онлайн-статуса членов организации (для получения доступа к этой функции API главам организаций необходимо обратиться в ЛС к грымза)
HTTP POST или GET запросом на url http://api.dozory.ru/query/?rm=org_member_status отправляется ID организации, текущая дата в формате "ДД.ММ.ГГГГ", список ID игроков, онлайн статус которых необходимо выяснить, шифрованые по алгоритму MD5 данные в следующей последовательности: ID организации, пароль, дата.
Пока можно отправить не более 50 ID членов организации за один запрос.

Пример:
http://api.dozory.ru/query/?rm=org_member_status&org_id=3&date=04.04.2007&
person_id=248&person_id=249&person_id=252&sign=8beb5e0436fc96f2b581d4e52dee3f0c

2. Просмотр складских операций организации за определённую дату (для получения доступа к этой функции API главам организаций необходимо обратиться в ЛС к грымза)
HTTP POST или GET запросом на url http://api.dozory.ru/query/?rm=org_storage_info отправляется ID организации, дата, за которую необходимо просмотреть операции на складе, в формате "ДД.ММ.ГГГГ", тип склада (основной - storage, дополнительный - aux_storage, склад модификаторов - mods_storage, склад проф.предметов - prof_storage, библиотека - lib_storage), шифрованые по алгоритму MD5 данные в следующей последовательности: ID организации, пароль, дата, тип склада.

Пример:
http://api.dozory.ru/query/?rm=org_storage_info&org_id=3&date=04.04.2007&type=storage&
sign=ca820ad57809f62eb7b4d13f5d4371a0

3. Просмотр операций в казне организации за определённую дату (для получения доступа к этой функции API главам организаций необходимо обратиться в ЛС к грымза)
HTTP POST или GET запросом на url http://api.dozory.ru/query/?rm=org_treasury_info отправляется ID организации, дата, за которую необходимо просмотреть операции в казне, в формате "ДД.ММ.ГГГГ", тип денежной операции (рубли - money, талеры - talers), шифрованые по алгоритму MD5 данные в следующей последовательности: ID организации, пароль, дата, тип денежной операции.

Пример:
http://api.dozory.ru/query/?rm=org_treasury_info&org_id=3&date=02.08.2007&type=money&
sign=ca820ad57809f62eb7b4d13f5d4371a0

4. Просмотр складских операций в частных магазинах за определённую дату (для получения доступа к этой функции API владельцам магазинов необходимо обратиться в ЛС к грымза)
HTTP POST или GET запросом на url http://api.dozory.ru/query/?rm=private_shop_storage отправляется ID частного магазина, дата, за которую необходимо просмотреть операции на складе, в формате "ДД.ММ.ГГГГ", шифрованые по алгоритму MD5 данные в следующей последовательности: ID частного магазина, пароль, дата.

Пример:
http://api.dozory.ru/query/?rm=private_shop_storage&ps_id=3&date=02.08.2007&
sign=ca820ad57809f62eb7b4d13f5d4371a0

5. Просмотр операций в казне частного магазина за определённую дату (для получения доступа к этой функции API владельцам магазинов необходимо обратиться в ЛС к грымза)
HTTP POST или GET запросом на url http://api.dozory.ru/query/?rm=private_shop_treasury отправляется ID частного магазина, дата, за которую необходимо просмотреть операции на складе, в формате "ДД.ММ.ГГГГ", шифрованые по алгоритму MD5 данные в следующей последовательности: ID частного магазина, пароль, дата.

Пример:
http://api.dozory.ru/query/?rm=private_shop_treasury&ps_id=3&date=02.08.2007&
sign=ca820ad57809f62eb7b4d13f5d4371a0

6. Получения основного и резервного составов организаций (для просмотра состава организаций с id от 1 до 6 необходимо обратиться в ЛС к грымза)
HTTP POST или GET запросом на url http://api.dozory.ru/query/?rm=org_members отправляется список ID организаций, информацию по которым Вы хотите получить.
Для просмотра организаций с id от 1 до 6 необходимо подавать следующие параметры: my_org_id - id вашей организации, sign - md5-хеш от пароля вашей организации
Список ID не ограничен.

Пример:
http://api.dozory.ru/query/?rm=org_members&org_id=513&org_id=104

7. Получения дополнительной информации по списку персонажей
HTTP POST или GET запросом на url http://api.dozory.ru/query/?rm=person_info отправляется список ID игроков, о которых Вы хотите получить информацию
Пока можно отправить не более 50 ID за один запрос.

Пример:
http://api.dozory.ru/query/?rm=person_info&person_id=248&person_id=249&person_id=252

Расшифровка полей:

  • person_id - ID персонажа
  • nick - никнейм
  • magic_level - магический уровень (от 8 до 0). 8 - человек 0 - вне категорий
  • magic_align - сторона Силы. Light - свет, Dark - тьма. Unknown - неопределившийся
  • org_id - ID организации
  • max_stamina - здоровье
  • max_energy - энергия
  • class_type_id - ID класса персонажа (1 - маги, 2 - ведьмы, 3 - оборотни, 4 - вампиры, 5 - инкубы)
  • sex - пол
  • tendency - склонность 1 - адепты, -1 - отверженные, 0 - свободные
  • reg_date - дата регистрации в формате unixtimestamp
  • init_date - дата инициации в формате unixtimestamp
  • last_login - дата последнего входа в игру в формате unixtimestamp
  • online_time - время онлайн в секундах
  • cnt_wins - количество побед
  • cnt_lose - количество поражений
Так как эта информация достаточно статичная (изменяется не очень часто, а если и меняется то это не критично) настоятельно рекомендуется слать запросы как можно реже и по возможности кешировать полученные данные на своей стороне. Для кеширования полученного XML мы можем порекомендовать memcached.

Дополнение:
Пример составления запроса на примере лога рублевых операций в казне организации.
  • ID организации, org_id=4
  • Дата операции, date=06.04.2015
  • Тип операции рубли, type=money
  • Пароль='password'
  • Sign='md5'
http://api.dozory.ru/query/?rm=org_treasury_info&org_id=46&date=06.04.2015&type=money&sign='md5'

Где 'md5' берется от 4'password'06.04.2015money (без запятых и пробелов) и составляет: c49b41a594f6cbda016b1d9fa4146827

Итоговый запрос будет выглядеть таким образом:

http://api.dozory.ru/query/?rm=org_treasury_info&org_id=46&date=06.04.2015&type=money&sign= c49b41a594f6cbda016b1d9fa4146827

Запросы к сервисам разрешается слать не чаще одного раза в 5ть секунд.

 
Дозоры.Ру © 2004-2016
С. Лукьяненко © 1998-2003