Розбіжності

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

--- xmlagent [2024/05/15 15:28]
bobr [Тарифи, на які користувач може перейти в особистому кабінеті]
+++ xmlagent [2025/10/21 12:59] (поточний)
nightfly [XMLAgent]
@@ Рядок 7: / Рядок 7: @@
   * **?xmlagent=true** - нутрощі користувача
+  * **?xmlagent=true&justauth=true** - просто перевіряє авторизацію не вивалюючи нутрощі користувача
   * **?xmlagent=true&payments=true** - попередні оплати користувача
   * **?xmlagent=true&announcements=true** - активні(публічні) оголошення кабінету користувача
+  * **?xmlagent=true&annreadall=true** - відмітити всі оголошення користувача як прочитані
   * **?xmlagent=true&tickets=true** - всі тікети користувача та відповіді на них
   * **?xmlagent=true&opayz=true** - доступні користувачу онлайнові платіжні засоби
   * **?xmlagent=true&agentassigned=true** - дані контрагента, асоційованого з користувачем
+  * **?xmlagent=true&ukv=true** - дані пов'язаного користувача [[ukv|УКВ]]
   * **?module=creditor&agentcredit=true&justcheck=true** - просто перевірити можливість встановлення кредиту
   * **?module=creditor&agentcredit=true** - попросити кредит на декілька днів
@@ Рядок 17: / Рядок 20: @@
-За замовчуванням, відповіді XMLAgent історично, будуть повернуті у вигляді **XML-документу**. \\
+За замовчуванням, відповіді XMLAgent, історично, будуть повернуті у вигляді **XML-документу**. \\
 Для отримання даних у вигляді **JSON-документу** просто додайте GET параметр **json=true**.
@@ Рядок 23: / Рядок 26: @@
 ====== Авторизація ======
-У випадку, якщо ви не хочете покладатися на примусову авторизацію користувачів за їх IP, наприклад використовуючи вашу додаток поза мережею, ви можете використовувати примусову авторизацію конкретного користувача, для всіх запитів прямим вказанням логіну та MD5 хешу паролю у вигляді наступних GET змінних:
+У випадку, якщо ви не хочете покладатися на примусову авторизацію користувачів за їх IP, наприклад використовуючи ваш додаток поза мережею, ви можете використовувати примусову авторизацію конкретного користувача прямим вказанням логіну та MD5 хешу паролю для всіх запитів у вигляді наступних GET змінних:
   * **uberlogin**
@@ Рядок 34: / Рядок 37: @@
 ?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>
+Так, як бачимо авторизація за логіном/паролем користувача та розширена аутентифікація доволі чудово собі співіснують в рамках одного запиту. \\
+Слід лише мати на увазі, що **авторизація за логіном/паролем користувача** є дещо опціональною і її вимагають далеко не всі запити - на відміну від **розширеної аутентифікації**, ввімкнення якої **зобов'язує** вас використовувати аутентифікаційний токен абсолютно для кожного запиту.
 У разі помилки авторизації, ви отримаєте відповідь у вигляді прямого рядка
@@ Рядок 276: / Рядок 288: @@
 \\
-===== Створення 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** створеної 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** у разі невдачі.
@@ Рядок 587: / Рядок 615: @@
 \\
-===== XMLAgent вимкнено конфігурацією =====
+====== Заморозка/розморозка користувача ======
+===== Отримання даних про стан замороженості користувача =====
+<code>http://demo.ubilling.net.ua:9999/billing/userstats/?xmlagent=true&freezedata=true</code>
+<code xml>
+<freezedata>
+    <result>Success</result>
+    <message/>
+    <freezeSelfAvailable>1</freezeSelfAvailable>
+    <activationCost>13</activationCost>
+    <tariffsAllowedList>Unlim-5,NEW_40_150_grn</tariffsAllowedList>
+    <tariffAllowedAny>1</tariffAllowedAny>
+    <negativeBalanceFreezeAllowed/>
+    <userBalance>-180.677419</userBalance>
+    <userTariff>10M_200grn</userTariff>
+    <userTariffFreezePrice>30</userTariffFreezePrice>
+    <freezeStatus>frozen</freezeStatus>
+    <dateFrom>2025-02-25 17:30:34</dateFrom>
+    <dateTo>2025-03-23 17:03:34</dateTo>
+    <freezeDaysChargeActive>1</freezeDaysChargeActive>
+    <freezeDaysTotal>365</freezeDaysTotal>
+    <freezeDaysRestore>120</freezeDaysRestore>
+    <freezeDaysUsed>26</freezeDaysUsed>
+    <freezeDaysAvailable>339</freezeDaysAvailable>
+    <freezeDaysWorked>0</freezeDaysWorked>
+    <freezeDaysLeftToWork>120</freezeDaysLeftToWork>
+</freezedata>
+</code>
+===== Заморозка користувача =====
+<code>http://demo.ubilling.net.ua:9999/billing/userstats/?xmlagent=true&dofreeze=true</code>
+Тут все доволі просто: може вертати повідомлення або про успішність операції:
+<code xml>
+<dofreeze>
+    <result>Success</result>
+    <message>User 'SomeUserLogin' has been frozen</message>
+</dofreeze>
+</code>
+або про те, що користувач вже заморожений:
+<code xml>
+<dofreeze>
+    <result>Failure</result>
+    <message>User 'SomeUserLogin' is already frozen</message>
+</dofreeze>
+</code>
+===== Розморозка користувача =====
+<code>http://demo.ubilling.net.ua:9999/billing/userstats/?xmlagent=true&dounfreeze=true</code>
+Повністю ідентична по своїй суті процедура до попередньої - тільки рівно з протилежним результатом. Але є важливі нюанси:
+  * щоби цей виклик в принципі працював опція XMLAGENT_SELF_UNFREEZE_ALLOWED в userstats.ini має бути ввімкненою
+  * майте на увазі, що ця операція виконується "as is" - без усіляких додаткових перевірок(так, просто в тупу міняється статус користувача) і дозволяє доволі боляче вистрілити собі в ногу. Так що - використовуйте сугубо на власний розсуд.
+Успішне виконання поверне ось такий месседж:
+<code xml>
+<dofreeze>
+    <result>Success</result>
+    <message>User 'SomeUserLogin' has been UNfrozen</message>
+</dofreeze>
+</code>
+якщо ж користувач НЕ заморожений - поверне отаке:
+<code xml>
+<dofreeze>
+    <result>Failure</result>
+    <message>User 'SomeUserLogin' is already UNfrozen</message>
+</dofreeze>
+</code>
+\\
+====== XMLAgent вимкнено конфігурацією ======
 У цьому випадку ми отримуємо помилку вигляду

Ubilling Wiki

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

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

Розбіжності

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