API личного кабинета

Работает только с разрешенного IP

Авторизация по логину и паролю учетной записи
Логин testlogin, пароль testpsw

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.login&arg1={"login":"testlogin","passwd":"testpsw"}

Авторизация по IP. Параметром передаётся IP, с которого производится авторизация - 10.20.30.41
```
http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.try_auto_login&arg1={"src_ip":"10.20.30.41"}
```
После авторизации будет получен уникальный ID сессии по которому возможно авторизовать все прочие запросы на получение данных и изменение абонента, например Вы получили ID 54ds34jklji8ufds8u945jkl, то это значение передается в параметре suid.

Получить информацию об абоненте

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.user_info&arg1={"suid":"54ds34jklji8ufds8u945jkl"}

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_user_info_sensitive&arg1={"contract_number":"testabonent","src_ip":"10.20.30.41","suid":"54ds34jklji8ufds8u945jkl"}

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_user&arg1={"suid":"54ds34jklji8ufds8u945jkl"}

Восстановление пароля к личному кабинету. Отправляет проверочный код абоненту.

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.reset_password&arg1={"login":"testlogin","base_url":null}

Восстановление пароля к личному кабинету. Меняет пароль на указанный, по token из сообщения абоненту.
```
http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.submit_password&arg1={"token":"F7987Z","uid":"324","psw1":"newpsw","psw2":"newpsw"}
```

Изменить данные абонента

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.set_user_info&arg1={"email":"test","sms":"+7999555555","user_mac":"00-B0-D0-63-C2-26","user_ask_password_lk":true,"user_password":"secrettest","limit_warning":"100.10","attrib_30":"test","suid":"54ds34jklji8ufds8u945jkl"}

Установить абоненту токен PUSH-уведомления из личного кабинета

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.save_push_token&arg1={"token":"testtoken","src_ip":"10.20.30.41","suid":"54ds34jklji8ufds8u945jkl"}

Проверка некоторых параметров. Возможные значения параметра what_check перечислены в статье про шорткод cabinet_check.
```
http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.check&arg1={"what_check":"empty_phone","suid":"54ds34jklji8ufds8u945jkl"}
```

Получить абонентскую плату за сегодня

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_abon_pay_for_today&arg1={"suid":"54ds34jklji8ufds8u945jkl"}

Прогнозируемая дата блокировки.

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_balance_until_date&arg1={"suid":"54ds34jklji8ufds8u945jkl"}

Получить список тарифов

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_tarifs&arg1={"show_all":false,"show_www":false,"show_archived":false,"suid":"54ds34jklji8ufds8u945jkl"}

Список услуг

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_usluga_list&arg1={"filter":"","get_user_uslugas_all":false,"get_user_uslugas":false,"get_setted":false,"suid":"54ds34jklji8ufds8u945jkl"}

Список подписок Megogo

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_megogo_services&arg1={"suid":"54ds34jklji8ufds8u945jkl"}

Список учётных записей IPTV

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_iptv_accounts&arg1={"suid":"54ds34jklji8ufds8u945jkl"}

Подключение услуги

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.set_user_usluga&arg1={"usluga_id":"96","suid":"54ds34jklji8ufds8u945jkl"}

Отключение услуги

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.remove_user_usluga&arg1={"usluga_id":"96","suid":"54ds34jklji8ufds8u945jkl"}

Подключить или отключить услугу

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.toggle_user_usluga&arg1={"usluga_id":"96","suid":"54ds34jklji8ufds8u945jkl"}

Включение или выключение интернета по желанию абонента

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.toogle_block&arg1={"block_type":"b_own2","suid":"54ds34jklji8ufds8u945jkl"}

Включить добровольную блокировку

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.block_user&arg1={"start_date":"01.01.2024","end_date":"01.02.2024","suid":"54ds34jklji8ufds8u945jkl"}

Отключить добровольную блокировку

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.disable_own_block&arg1={"suid":"54ds34jklji8ufds8u945jkl"}

Получить историю платежей

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_pay_log&arg1={"start_date":"01.01.2022","end_date":"01.01.2024","page_number":1,"per_page":50,"suid":"54ds34jklji8ufds8u945jkl"}

Получить историю списаний

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_credit_log&arg1={"start_date":"01.01.2022","end_date":"01.01.2024","page_number":1,"per_page":50,"suid":"54ds34jklji8ufds8u945jkl"}

Получить историю потребления трафика

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_traffic_log&arg1={"start_date":"01.01.2022","end_date":"01.01.2024","page_number":1,"per_page":50,"suid":"54ds34jklji8ufds8u945jkl"}

Получить историю звонков

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_voip_log&arg1={"start_date":"01.01.2023","end_date":"01.02.2023","page_number":1,"per_page":50,"suid":"54ds34jklji8ufds8u945jkl"}

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_voip_log_fullrange&arg1={"start_date":"01.01.2023","end_date":"01.02.2023","suid":"54ds34jklji8ufds8u945jkl"}

Получить стоимость звонков

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_voip_log_fullrange_billsum&arg1={"start_date":"01.01.2023","end_date":"01.02.2023","suid":"54ds34jklji8ufds8u945jkl"}

Получить текущий тариф

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_user_tarif&arg1={"suid":"54ds34jklji8ufds8u945jkl"}

Сменить тариф

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.change_user_tarif&arg1={"tarif_id":1,"suid":"54ds34jklji8ufds8u945jkl"}

Получить список обещанных платежей доступных в ЛК

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_promise_pay_list&arg1={"suid":"54ds34jklji8ufds8u945jkl"}

Получить обещанный платеж

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_promise_pay&arg1={"promise_pay_id":null,"suid":"54ds34jklji8ufds8u945jkl"}

Подключить обещанный платёж

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.add_promise_pay&arg1={"promise_pay_id":null,"suid":"54ds34jklji8ufds8u945jkl"}

Получить логин учётной записи и ID абонента

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_user_login&arg1={"user_id":324,"suid":"54ds34jklji8ufds8u945jkl"}

Получить уведомления

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_notifications_for_user&arg1={"suid":"54ds34jklji8ufds8u945jkl"}

Инициализация начала проведения платежа (тип операции ADD)

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.add_payment_operation&arg1={"suid": "54ds34jklji8ufds8u945jkl", "contract_number": "BILL0000007", "summa_in": "100.00", "operator": "SBERBANK_ACQ", "src_ip": "10.20.30.41"}

Инициализация начала проведения платежа (тип операции ADD) без авторизации. Используется в Форма для оплаты без авторизации Альфа-Банк (Интернет Эквайринг)
```
http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.add_payment_operation_direct&arg1={"suid": null, "contract_number": "BILL0000007", "summa_in": "100.00", "operator": "SBERBANK_ACQ", "src_ip": "10.20.30.41"}
```

Обновление данных о платеже.

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.update_payment_operation&arg1={"suid": "54ds34jklji8ufds8u945jkl", "action": "ID", "operation_id": "1", "new_operation_id": "222", "new_ext_id": "333", "text": "комментарий", "operator": "SBERBANK_ACQ"}

Обновление данных о платеже без авторизации. Используется в Форма для оплаты без авторизации Альфа-Банк (Интернет Эквайринг)

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.update_payment_operation_direct&arg1={"contract_number": "BILL0000007", "action": "ID", "operation_id": "1", "new_operation_id": "222", "new_ext_id": "333", "text": "комментарий", "operator": "SBERBANK_ACQ"}

Получить информацию из журнала платежей

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_payment_operation&arg1={"suid": "54ds34jklji8ufds8u945jkl", "operation_id": "1"}

Включение автоплатежа (требует оплаты)

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.add_autopay_payment_operation&arg1={"suid": "54ds34jklji8ufds8u945jkl", "operator": "PAYMASTER", "src_ip": "10.20.30.41"}

Отключение автоплатежа

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.disable_autopay&arg1={"suid": "54ds34jklji8ufds8u945jkl", "src_ip": "10.20.30.41"}

Информация об автоплатеже

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_autopay_info&arg1={"suid": "54ds34jklji8ufds8u945jkl"}

Платеж через карту оплаты

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.add_card_payment_operation&arg1={"suid": "54ds34jklji8ufds8u945jkl", "series_no": "123", "card_key": "321", "src_ip": "10.20.30.41"}

Самый дорогой из доступных тарифов

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_best_tarif&arg1={"suid": "54ds34jklji8ufds8u945jkl"}

Информация о лицевом счёте

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_account_info&arg1={"suid": "54ds34jklji8ufds8u945jkl"}

Статус абонента (тариф, блокировка, дата активации)

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_abonent_status&arg1={"suid": "54ds34jklji8ufds8u945jkl"}

Расходы за месяц по услугам

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_month_expenses&arg1={"suid": "54ds34jklji8ufds8u945jkl"}

Дерево домов

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_homes_tree&arg1={}

Заявка на подключение, обязательные поля contact_name и phone_number

http://10.90.214.4:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.apply_for_connection&arg1={"contact_name": "Иван", "phone_number": "+7999555555", "contact_email": "", "home": 1, "comment": "Подключение с Интернету", "operator_id": 3}

CRM. HelpDesk Список заявок

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_helpdesk_dialogs&arg1={"suid": "54ds34jklji8ufds8u945jkl", "parent_id": null}

CRM. HelpDesk Комментарии к заявке

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_helpdesk_comments&arg1={"suid": "54ds34jklji8ufds8u945jkl", "parent_id": 1}

CRM. HelpDesk Создать заявку или добавить комментарий

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.create_ticket&arg1={"suid": "54ds34jklji8ufds8u945jkl", "ticket_text": "Прошу помочь", "subj": "Заявка", "parent_id": null, "status": 1}

Получить USER ID

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_user_id&arg1={"suid": "54ds34jklji8ufds8u945jkl"}

Краткая сводка о расходах и приходах

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_simple_statistics&arg1={"suid": "54ds34jklji8ufds8u945jkl"}

История смены тарифов через "Дата следующего перехода" в карточке абонента

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_tarif_change_history&arg1={"suid": "54ds34jklji8ufds8u945jkl"}

Пробует определить MAC пользователя, отправив событие user_get_mac на оборудование, а потом записать его в учётную запись
```
http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.change_mac&arg1={"suid": "54ds34jklji8ufds8u945jkl"}
```

Всегда возвращает status=1

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.service_status&arg1={"suid": "54ds34jklji8ufds8u945jkl"}

Глобальные настройки биллинга и оператора Доступны: 170004

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_vpn_const&arg1={"suid": "54ds34jklji8ufds8u945jkl"}

Проверка на вход учётной записи в служебную группу

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.is_admin&arg1={"suid": "54ds34jklji8ufds8u945jkl"}

Список доступных для скачивания документов

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.pdf_list&arg1={"suid": "54ds34jklji8ufds8u945jkl"}

Скачать документ в PDF по ID финансовой операции

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_pdf&arg1={"suid": "54ds34jklji8ufds8u945jkl", "operation_id": 13243}

Получение данных Radius-сессий для СОРМ, используется в шорткоде cabinet_detail_search

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.detail_search&arg1={"suid": "54ds34jklji8ufds8u945jkl"}

Выполнение отчёта, подробнее в Отчёты в личном кабинете

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.report_exec&arg1={"suid": "54ds34jklji8ufds8u945jkl", "report_id": 1, "args":{}}

Передать параметры в отчёт:

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.report_exec&arg1={"suid": "54ds34jklji8ufds8u945jkl", "report_id": 1, "args":{"date_start|date":"01.10.2024", "date_end|date":"31.10.2024" }}

В каждом запросе автоматически передаётся параметр abonent_id содержащий ID, авторизованного абонента.

Получить наборы правил Правила и сети

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_subnet_list&arg1={"suid": "54ds34jklji8ufds8u945jkl"}

Конвертация баллов

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.convert_bonus&arg1={"suid": "54ds34jklji8ufds8u945jkl", "src_ip": "10.20.30.41", "bonus_value": "10.00"}

Список домов

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.get_all_homes&arg1={}

Перевод денег другу

http://169.254.80.82:8082/system_api/?format=json&context=web&model=users&method1=web_cabinet.transfer_money&arg1={"suid": "54ds34jklji8ufds8u945jkl", "amount": "10.00", "to": "BILL0000012"}

Более подробно о параметрах на примере пункта 35:

suid - уникальный ID сессии;

operation_id - текущий ID платежа (pay_id_str_in);

operator - платёжная система (pay_operator), если указана, то участвует в поиске записи в журнале платежей (так как может быть ситуация с одинаковыми идентификаторами платежей в разных платёжных системах);

action - какой параметр записи в журнале платежей необходимо изменить:

ID - меняет ID платежа в биллинге (pay_id_str_in)
EXT_ID - меняет внешний ID, идентификатор платежа внутри платёжной системы (ext_id)
COMMENT - поле комментарий (comment_out);

new_operation_id - если изменяется ID, то в параметре указывается новое значение;

new_ext_id - если изменяется EXT_ID, то в параметре указывается новое значение;

text - если изменяется COMMENT, то в параметре указывается новое значение;

В аудит абонента записывается:
"Обновление информации % по платежу pk % #% из ЛК";

В ответе на запрос:
operation_id_out: ID платежа (pay_id_str_in)
ext_id: Внешний ID (ext_id)
comment_out: Комментарий (comment_out).

API личного кабинета

API личного кабинета

Метки