Розбіжності

Тут показані розбіжності між вибраною ревізією та поточною версією сторінки.

--- xmlagent [2024/03/22 20:48]
bobr [Створення signup-тікету (тобто заявки на підключення)]
+++ xmlagent [2024/07/13 13:19] (поточний)
bobr [Авторизація]
@@ Рядок 17: / Рядок 17: @@
-За замовчуванням, відповіді XMLAgent історично, будуть повернуті у вигляді **XML-документу**. \\
+За замовчуванням, відповіді XMLAgent, історично, будуть повернуті у вигляді **XML-документу**. \\
 Для отримання даних у вигляді **JSON-документу** просто додайте GET параметр **json=true**.
@@ Рядок 23: / Рядок 23: @@
 ====== Авторизація ======
-У випадку, якщо ви не хочете покладатися на примусову авторизацію користувачів за їх IP, наприклад використовуючи вашу додаток поза мережею, ви можете використовувати примусову авторизацію конкретного користувача, для всіх запитів прямим вказанням логіну та MD5 хешу паролю у вигляді наступних GET змінних:
+У випадку, якщо ви не хочете покладатися на примусову авторизацію користувачів за їх IP, наприклад використовуючи ваш додаток поза мережею, ви можете використовувати примусову авторизацію конкретного користувача прямим вказанням логіну та MD5 хешу паролю для всіх запитів у вигляді наступних GET змінних:
   * **uberlogin**
@@ Рядок 34: / Рядок 34: @@
 ?xmlagent=true&uberlogin=gen_vj7iyagnzj&uberpassword=614e8c88061bc45a75fdc1b2eefe1e84
 </code>
+Починаючи з релізу 1.4.7 доступний додатковий базовий рівень так званої "розширеної" аутентифікації, яка використовує **MD5 хеш серійного номеру вашого інстансу UB** як додатковий аутентифікаційний токен, на кшталт [[remoteapi|RemoteAPI]]. Стан ввімкненості розширеної аутентифікації керується опцією [[userstats|userstats.ini]] - [[userstats#xmlagent_extended_auth_on|XMLAGENT_EXTENDED_AUTH_ON]]. \\
+Аутентифікаційний токен передається відповідним GET-параметром **uberkey**. \\
+Виглядає це все загалом якось так:
+<code>
+?xmlagent=true&uberlogin=gen_vj7iyagnzj&uberpassword=614e8c88061bc45a75fdc1b2eefe1e84&uberkey=6fde545feaaba6952d9cdba84ad26475
+</code>
+Так, як бачимо авторизація за логіном/паролем користувача та розширена аутентифікація доволі чудово собі співіснують в рамках одного запиту. \\
+Слід лише мати на увазі, що **авторизація за логіном/паролем користувача** є дещо опціональною і її вимагають далеко не всі запити - на відміну від **розширеної аутентифікації**, ввімкнення якої **зобов'язує** вас використовувати аутентифікаційний токен абсолютно для кожного запиту.
 У разі помилки авторизації, ви отримаєте відповідь у вигляді прямого рядка
@@ Рядок 58: / Рядок 67: @@
   * поточне REST API може працювати без авторизаці, а значить, теоретично, доступ до певних даних вашої БД може отримати будь-хто
   * не треба занадто самовпевнено думати, що "тааа - мій **userstats** за NATом - шо там мені загрожує?" - бо це не так
-  * ніколи не відкривайте XMLAgent "просто в світ" - як мінімум - налаштуйте безпечні хости/IP на своєму веб сервері та/або фаєрволі, з яких буде дозволено робити запити до вашого XMLAgent. Можна ще й **reverse-proxy** заюзати - лишнім не буде
+  * ніколи не відкривайте XMLAgent "просто в світ" - як мінімум - налаштуйте allowed хости/IP на своєму веб сервері та/або фаєрволі, з яких буде дозволено робити запити до вашого XMLAgent. Можна ще й **reverse-proxy** заюзати - лишнім не буде
 ====== Приклади запитів та відповідей ======
@@ Рядок 189: / Рядок 198: @@
   * **dateto=2024-01-21**   - дата **по**
 Ці параметри абсолютно незалежні один від і одного і передавати можна будь-який з них окремо. Відповідно, отримаємо всі записи від "Різдва Христова"(тобто від появи користувача в біллінгу) до **dateto**, або ж від **datefrom** до поточної дати. \\
-Також варто зазначити, що в полях **note** та **type** для віртуальних сервісів будуть стояти **Найменування віртуального сервісу**(тобто - найменування тегу) та **virtualsrv** відповідно.
+Також варто зазначити, що в полях **note** та **type** для віртуальних сервісів будуть вказані **Найменування віртуального сервісу**(тобто - найменування тегу) та **virtualsrv** відповідно.
 <code xml>
@@ Рядок 276: / Рядок 285: @@
 \\
-===== Створення support-тікету (тобто запиту в техпідтримку)=====
+===== Створення support-тікету (тобто запиту в техпідтримку) =====
 <code>http://demo.ubilling.net.ua:9999/billing/userstats/?xmlagent=true&ticketcreate=true&tickettype=support_request&tickettext=U29tZSB0aWNrZXQgdGV4dCBmb3Igc3VwcG9ydCB0ZWFt</code>
 Так, ви все правильно здогадалися: параметр **tickettext** має містити текст тікету закодований у **BASE64**. \\
-Цей запит повертає **created = success** та **ID** створеної заявки на підключення у разі успіху або **created = error** та **ID = 0** у разі невдачі.
+Цей запит повертає **created = success** та **ID** створеної support-заявки разі успіху або **created = error** та **ID = 0** у разі невдачі.
+<code xml>
+<?xml version="1.0" encoding="utf-8"?>
+<data>
+	<created>success</created>
+	<id>9</id>
+</data>
+</code>
+==== Відповідь на support-тікет ====
+<code>http://demo.ubilling.net.ua:9999/billing/userstats/?xmlagent=true&ticketcreate=true&tickettype=support_request&reply_id=6&tickettext=U29tZSB0aWNrZXQgdGV4dCBmb3Igc3VwcG9ydCB0ZWFt</code>
+Все теж саме, що й у минулому запиті, крім додаткового параметру **reply_id=6**, що має містити **ID** тікета, на який дається відповідь. \\
+**Слід мати на увазі**, що **reply_id** має буть саме IDшкою тікету, а не IDшкою якогось вже існуючого реплаю. Тобто, в такого запису в БД поле **replyid** має бути **нуль/NULL/пустим**. \\
+Цей запит повертає **created = success** та **ID** створеної support-заявки разі успіху або **created = error** та **ID = 0** у разі невдачі.
 <code xml>
@@ Рядок 312: / Рядок 337: @@
 </code>
-Варто зазначити, що поля **state** та **service** - статичні і їх значення міняти **НЕ треба**
+Варто зазначити, що поля **state** та **service** - статичні і їх значення міняти **НЕ треба**. \\
 Цей запит повертає **created = success** та **ID** створеної заявки на підключення у разі успіху або **created = error** та **ID = 0** у разі невдачі.
@@ Рядок 524: / Рядок 549: @@
 </code>
 \\
+===== Тарифи, на які користувач може перейти в особистому кабінеті =====
+<code>http://demo.ubilling.net.ua:9999/billing/userstats/?xmlagent=true&tarifftoswitchallowed=true</code>
+Потребує ввімкненого функціоналу самостійної зміни тарифу в особистому кабінеті користувача. \\
+Так-так: оті всі опції **TC_*** з [[userstats|userstats.ini]] + [[tariffmatrix|tariffmatrix.ini]]. \\
+Виклик повертає дані опції **TC_TARIFFSALLOWED**, якщо тариф користувача міститься в списку **TC_TARIFFENABLEDFROM** або відповідні дані з **tariffmatrix.ini** (знову ж таки, якщо його поточний тариф там фігурує). У всіх інших випадках виклик повертає **нічого**.
+<code xml>
+<?xml version="1.0" encoding="utf-8"?>
+<data>
+    <tarifftoswitchallowed>
+        <tariff>30M_50grn_FREE</tariff>
+    </tarifftoswitchallowed>
+    <tarifftoswitchallowed>
+        <tariff>30M_70grn_Sale</tariff>
+    </tarifftoswitchallowed>
+    <tarifftoswitchallowed>
+        <tariff>40M_Pon_150grn_N</tariff>
+    </tarifftoswitchallowed>
+    <tarifftoswitchallowed>
+        <tariff>Mur_100M_150grn</tariff>
+    </tarifftoswitchallowed>
+</data>
+</code>
+\\
 ===== Всі поточні активні тарифи та віртуальні сервіси провайдеру =====

Ubilling Wiki

Користувальницькькі налаштування

Налаштування сайту

Розбіжності

Налаштування сторінки