Запросы:
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ть секунд.