Инструменты пользователя

Инструменты сайта


Боковая панель

Разделы

Общее описание
История изменений
Рекомендации к обновлению
Планы на будущее
Известные проблемы
Онлайн демо
Случайная статья
Видео
Помощь проекту
Люди

FAQ



Редактировать сайдбар

xmlagent

Это старая версия документа!


XMLAgent

Для внешних приложений взаимодействующих с кабинетом пользователя, поддерживается отдельное REST API. Получить доступ к нему можно при помощи следующих URL:

  • ?xmlagent=true - внутренности пользователя
  • ?xmlagent=true&payments=true - предыдущие платежи пользователя
  • ?xmlagent=true&announcements=true - активные объявления кабинета пользователя
  • ?xmlagent=true&tickets=true - все тикеты пользователя и ответы на них
  • ?xmlagent=true&opayz=true - доступные пользователю онлайн-платежки.

По умолчанию ответы XMLAgent будут возвращены в виде XML данных. Также возможно добавление GET параметра json=true для получения данных в виде JSON-массива.

Авторизация

В случае, если вы не хотите полагаться на принудительную авторизацию пользователей по IP, например используя ваше приложение вне сети, вы можете использовать принудительную авторизацию конкретного пользователя, для всех запросов прямым указанием логина и MD5 хэша пароля в виде следующих GET переменных:

  • uberlogin
  • uberpassword

И как пример авторизации пользователя с логином sometestuser и паролем etopizdets

?xmlagent=true&uberlogin=sometestuser&uberpassword=577b23915317815883df587540f509b6

В случае ошибки авторизации, вы получите ответ в виде прямой строки

ERROR_WRONG_UBERAUTH

Принудительная авторизация имеет приоритет перед всеми стандартными типами авторизации, такими как ip,login,both.

Примеры запросов и ответов

Общие данные пользователя

http://demo.ubilling.net.ua:9999/billing/userstats/?xmlagent=true
<?xml version="1.0" encoding="utf-8"?>
<userdata>
	<address>Зловещенск Шевченка 11/8</address>
	<realname>Федір Крюгер</realname>
	<login>zlo_hev11ap8_0nt6</login>
	<cash>315</cash>
	<ip>172.30.0.2</ip>
	<phone>26666</phone>
	<mobile>0506661488</mobile>
	<email>fred@ourisp.ua</email>
	<credit>0</credit>
	<creditexpire>No</creditexpire>
	<payid>2887647234</payid>
	<contract>666</contract>
	<tariff>Unlim-100</tariff>
	<tariffnm>No</tariffnm>
	<traffdownload>0 b</traffdownload>
	<traffupload>0 b</traffupload>
	<trafftotal>0 b</trafftotal>
	<accountstate>active</accountstate>
	<accountexpire>102</accountexpire>
	<currency>UAH</currency>
	<version>1</version>
</userdata>

Общие данные пользователя но с авторизацией

http://demo.ubilling.net.ua:9999/billing/userstats/?xmlagent=true&uberlogin=zlo_hev11ap8_0nt6&uberpassword=bc988f975800bec5d2a572c6b7618865
<?xml version="1.0" encoding="utf-8"?>
<userdata>
	<address>Зловещенск Безысходная 14/108</address>
	<realname>Герман Быков</realname>
	<login>gen_xmz0jd4420</login>
	<cash>152</cash>
	<ip>172.30.0.131</ip>
	<phone>342317</phone>
	<mobile>3808156010</mobile>
	<email></email>
	<credit>0</credit>
	<creditexpire>No</creditexpire>
	<payid>2887647363</payid>
	<contract></contract>
	<tariff>Unlim-5</tariff>
	<tariffnm>No</tariffnm>
	<traffdownload>0 b</traffdownload>
	<traffupload>0 b</traffupload>
	<trafftotal>0 b</trafftotal>
	<accountstate>active</accountstate>
	<accountexpire>102</accountexpire>
	<currency>UAH</currency>
	<version>1</version>
</userdata>

Информация о предыдущих платежах пользователя

http://demo.ubilling.net.ua:9999/billing/userstats/?xmlagent=true&payments=true
<?xml version="1.0" encoding="utf-8"?>
<data>
<payment>
	<date>2020-01-13 13:26:11</date>
	<summ>50</summ>
	<balance>265</balance>
</payment>
<payment>
	<date>2017-05-25 12:28:43</date>
	<summ>45</summ>
	<balance>265</balance>
</payment>
<payment>
	<date>2015-06-05 15:59:00</date>
	<summ>10</summ>
	<balance>255</balance>
</payment>
<payment>
	<date>2015-03-30 13:41:25</date>
	<summ>100</summ>
	<balance>155</balance>
</payment>
<payment>
	<date>2014-06-24 18:17:59</date>
	<summ>50</summ>
	<balance>105</balance>
</payment>
<payment>
	<date>2011-10-08 16:03:25</date>
	<summ>50</summ>
	<balance>55</balance>
</payment>
<payment>
	<date>2011-09-30 18:58:21</date>
	<summ>5</summ>
	<balance>50</balance>
</payment>
<payment>
	<date>2011-09-03 20:50:30</date>
	<summ>50</summ>
	<balance>0</balance>
</payment>
</data>

Платежи пользователя, но в виде JSON

http://demo.ubilling.net.ua:9999/billing/userstats/?xmlagent=true&payments=true&json=true

Активные объявления кабинета пользователя

http://demo.ubilling.net.ua:9999/billing/userstats/?xmlagent=true&announcements=true
<?xml version="1.0" encoding="utf-8"?>
<data>
<message unic="1" title="Мы все умрем">это точно</message>
</data>

Все тикеты пользователя

http://demo.ubilling.net.ua:9999/billing/userstats/?xmlagent=true&tickets=true
<?xml version="1.0" encoding="utf-8"?>
<data>
<ticket>
	<id>3</id>
	<date>2020-09-22 15:37:53</date>
	<from>_he12ap1_rkh2</from>
	<to></to>
	<replyid>1</replyid>
	<status>0</status>
	<text>user reply</text>
</ticket>
<ticket>
	<id>2</id>
	<date>2020-09-22 15:36:50</date>
	<from>NULL</from>
	<to>_he12ap1_rkh2</to>
	<replyid>1</replyid>
	<status>0</status>
	<text>admin reply</text>
</ticket>
<ticket>
	<id>1</id>
	<date>2020-09-22 15:36:36</date>
	<from>_he12ap1_rkh2</from>
	<to></to>
	<replyid></replyid>
	<status>1</status>
	<text>my ticket</text>
</ticket>
</data>

Платежные системы

http://demo.ubilling.net.ua:9999/billing/userstats/?xmlagent=true&opayz=true
<?xml version="1.0" encoding="utf-8"?>
<data>
<paysys>
	<name>easypay</name>
	<url>http://op.ourisp.com/backend/easypay/?customer_id=3232235528</url>
	<description>VISA, MasterCard</description>
</paysys>
<paysys>
	<name>mypayprivat</name>
	<url>http://op.ourisp.com/backend/mypayprivat/?customer_id=3232235528</url>
	<description>VISA, MasterCard</description>
</paysys>
</data>

XML Agent отключен конфигурацией

В этом случае мы получаем ошибку вида

<?xml version="1.0" encoding="utf-8"?>
<error>
	<reason>disabled</reason>
</error>

Включение

Требуется включить соответствующую опцию в userstats.ini

 UBA_ENABLED=1
xmlagent.1601237741.txt.gz · Последние изменения: 2020/09/27 23:15 — mixtery