Розбіжності

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

--- xmlagent [2024/07/13 12:52]
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** - попросити кредит на декілька днів
@@ Рядок 35: / Рядок 38: @@
 </code>
-Починаючи з релізу 1.4.7 доступний додатковий базовий рівень так званої "розширеної" аутентифікації, яка використовує серійний номер UB як додатковий аутентифікаційний токен, на кшталт [[remoteapi|RemoteAPI]]. Стан ввімкненості розширеної аутентифікації керується опцією [[userstats|userstats.ini]] - [[userstats#xmlagent_extended_auth_on|XMLAGENT_EXTENDED_AUTH_ON]].
+Починаючи з релізу 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>
+Так, як бачимо авторизація за логіном/паролем користувача та розширена аутентифікація доволі чудово собі співіснують в рамках одного запиту. \\
+Слід лише мати на увазі, що **авторизація за логіном/паролем користувача** є дещо опціональною і її вимагають далеко не всі запити - на відміну від **розширеної аутентифікації**, ввімкнення якої **зобов'язує** вас використовувати аутентифікаційний токен абсолютно для кожного запиту.
 У разі помилки авторизації, ви отримаєте відповідь у вигляді прямого рядка
@@ Рядок 605: / Рядок 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

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

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

Розбіжності

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