Ubilling Wiki

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

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

Відвідано:
xmlagent

Розбіжності

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

Посилання на цей список змін

Порівняння попередніх версій Попередня ревізія
Наступна ревізія 		Попередня ревізія
xmlagent [2024/03/22 20:27]
bobr [Створення signup-тікету (тобто заявки на підключення)] 		xmlagent [2024/04/06 01:33] (поточний)
bobr [Створення support-тікету (тобто запиту в техпідтримку)]
Рядок 4: Рядок 4:
 Починаючи з релізу 1.4.5 **XMLAgent REST API** тепер винесено у окремий клас і додано багацько нових викликів. Починаючи з релізу 1.4.5 **XMLAgent REST API** тепер винесено у окремий клас і додано багацько нових викликів.
  
-Отримати доступ до **XMLAgent REST API** можна за допомогою таких URL:+Приклади URL для створення запитів до **XMLAgent REST API** (детальніше дивіться в описі кожного запиту нижче):
  
   * **?xmlagent=true** - нутрощі користувача   * **?xmlagent=true** - нутрощі користувача
Рядок 58: Рядок 58:
   * поточне REST API може працювати без авторизаці, а значить, теоретично, доступ до певних даних вашої БД може отримати будь-хто   * поточне REST API може працювати без авторизаці, а значить, теоретично, доступ до певних даних вашої БД може отримати будь-хто
   * не треба занадто самовпевнено думати, що "тааа - мій **userstats** за NATом - шо там мені загрожує?" - бо це не так   * не треба занадто самовпевнено думати, що "тааа - мій **userstats** за NATом - шо там мені загрожує?" - бо це не так
-  * ніколи не відкривайте XMLAgent "просто в світ" - як мінімум - налаштуйте безпечні хости/IP на своєму веб сервері та/або фаєрволі, з яких буде дозволено робити запити до вашого XMLAgent. Можна ще й **reverse-proxy** заюзати - лишнім не буде+  * ніколи не відкривайте XMLAgent "просто в світ" - як мінімум - налаштуйте allowed хости/IP на своєму веб сервері та/або фаєрволі, з яких буде дозволено робити запити до вашого XMLAgent. Можна ще й **reverse-proxy** заюзати - лишнім не буде
  
 ====== Приклади запитів та відповідей ====== ====== Приклади запитів та відповідей ======
Рядок 93: Рядок 93:
  
 </code> </code>
 +\\
  
 ===== Загальні дані користувача але з примусовою авторизацією ===== ===== Загальні дані користувача але з примусовою авторизацією =====
Рядок 126: Рядок 127:
  
 </code> </code>
 +\\
  
 ===== Інформація про попередні платежі користувача ===== ===== Інформація про попередні платежі користувача =====
Рядок 179: Рядок 181:
  
 <code>http://demo.ubilling.net.ua:9999/billing/userstats/?xmlagent=true&payments=true&json=true</code> <code>http://demo.ubilling.net.ua:9999/billing/userstats/?xmlagent=true&payments=true&json=true</code>
 +\\
  
- +===== Списання коштів з рахунку користувача =====
-===== Списання коштів з рахунку абонента =====+
 <code>http://demo.ubilling.net.ua:9999/billing/userstats/?xmlagent=true&feecharges=true</code> <code>http://demo.ubilling.net.ua:9999/billing/userstats/?xmlagent=true&feecharges=true</code>
 Цей виклик підтримує фільтрацію по даті **з - по**. Для цього треба передати відповідні параметри: Цей виклик підтримує фільтрацію по даті **з - по**. Для цього треба передати відповідні параметри:
Рядок 187: Рядок 189:
   * **dateto=2024-01-21**   - дата **по**   * **dateto=2024-01-21**   - дата **по**
 Ці параметри абсолютно незалежні один від і одного і передавати можна будь-який з них окремо. Відповідно, отримаємо всі записи від "Різдва Христова"(тобто від появи користувача в біллінгу) до **dateto**, або ж від **datefrom** до поточної дати. \\ Ці параметри абсолютно незалежні один від і одного і передавати можна будь-який з них окремо. Відповідно, отримаємо всі записи від "Різдва Христова"(тобто від появи користувача в біллінгу) до **dateto**, або ж від **datefrom** до поточної дати. \\
-Також варто зазначити, що в полях **note** та **type** для віртуальних сервісів будуть стояти **Найменування віртуального сервісу**(тобто - найменування тегу) та **virtualsrv** відповідно.+Також варто зазначити, що в полях **note** та **type** для віртуальних сервісів будуть вказані **Найменування віртуального сервісу**(тобто - найменування тегу) та **virtualsrv** відповідно.
  
 <code xml> <code xml>
Рядок 222: Рядок 224:
 </data> </data>
 </code> </code>
- +\\
  
 ===== Активні оголошення кабінету користувача ===== ===== Активні оголошення кабінету користувача =====
Рядок 234: Рядок 235:
 </data> </data>
 </code> </code>
 +\\
  
 ===== Усі тікети користувача ===== ===== Усі тікети користувача =====
Рядок 273: Рядок 274:
  
 </code> </code>
 +\\
  
 ===== Створення support-тікету (тобто запиту в техпідтримку)===== ===== Створення support-тікету (тобто запиту в техпідтримку)=====
Рядок 279: Рядок 280:
 <code>http://demo.ubilling.net.ua:9999/billing/userstats/?xmlagent=true&ticketcreate=true&tickettype=support_request&tickettext=U29tZSB0aWNrZXQgdGV4dCBmb3Igc3VwcG9ydCB0ZWFt</code> <code>http://demo.ubilling.net.ua:9999/billing/userstats/?xmlagent=true&ticketcreate=true&tickettype=support_request&tickettext=U29tZSB0aWNrZXQgdGV4dCBmb3Igc3VwcG9ydCB0ZWFt</code>
  
-Цей запит повертає **"success"** та ID створеного тікету у разі успіху або **"error"** та ID - 0 у разі невдачі.+Так, ви все правильно здогадалися: параметр **tickettext** має містити текст тікету закодований у **BASE64**. \\ 
 +Цей запит повертає **created = success** та **ID** створеної support-заявки разі успіху або **created = error** та **ID = 0** у разі невдачі.
  
 <code xml> <code xml>
Рядок 288: Рядок 290:
 </data> </data>
 </code> </code>
- +\\
  
 ===== Створення signup-тікету (тобто заявки на підключення)===== ===== Створення signup-тікету (тобто заявки на підключення)=====
Рядок 311: Рядок 312:
 </code> </code>
  
-Цей запит повертає **"success"** та ID створеної заявки на підключення у разі успіху або **"error"** та ID - 0 у разі невдачі.+Варто зазначити, що поля **state** та **service** - статичні і їх значення міняти **НЕ треба**. \\ 
 +Цей запит повертає **created = success** та **ID** створеної заявки на підключення у разі успіху або **created = error** та **ID = 0** у разі невдачі.
  
 <code xml> <code xml>
Рядок 320: Рядок 322:
 </data> </data>
 </code> </code>
 +\\
  
 ===== Платіжні системи OpenPayz ===== ===== Платіжні системи OpenPayz =====
Рядок 339: Рядок 342:
 </data> </data>
 </code> </code>
 +\\
  
 ===== Кредитування ===== ===== Кредитування =====
Рядок 432: Рядок 436:
    * currency - валюта кабінету користувача    * currency - валюта кабінету користувача
    * creditintro - короткий опис послуги в локалі кабінету за замовчуванням    * creditintro - короткий опис послуги в локалі кабінету за замовчуванням
 +\\
  
 ===== Картки поповнення ===== ===== Картки поповнення =====
Рядок 466: Рядок 471:
  
 </code> </code>
 +\\
  
 ===== Асоційований з користувачем контрагент ===== ===== Асоційований з користувачем контрагент =====
Рядок 493: Рядок 499:
 </data> </data>
 </code> </code>
 +\\
  
 ===== Поточний тариф та всі віртуальні сервіси користувача ===== ===== Поточний тариф та всі віртуальні сервіси користувача =====
Рядок 517: Рядок 523:
 </data> </data>
 </code> </code>
 +\\
  
 ===== Всі поточні активні тарифи та віртуальні сервіси провайдеру ===== ===== Всі поточні активні тарифи та віртуальні сервіси провайдеру =====
Рядок 552: Рядок 559:
 </data> </data>
 </code> </code>
 +\\
  
 ===== XMLAgent вимкнено конфігурацією ===== ===== XMLAgent вимкнено конфігурацією =====
xmlagent.1711132051.txt.gz · Востаннє змінено: 2024/03/22 20:27 повз bobr

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

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki