| При составлении api запросов к биллингу рекомендуется использовать API REST v2.0 |
Настройка
1. Необходимо добавить разрешенные IP адреса в список через пробел Настройки->Настройки(в файле) >Network >Список IP для которых разрешено подключаться к системному API и перезапустить веб-сервер в контейнере биллинга выполнив команду:
| Внимание:адреса должны указываться через пробел. |
2. Узнать пароль для конкретного контекста в /app/asr_billing/cfg/config
Например для collector будет:
Примеры запросов
Ответ у всех 3 запросов в виде текста где в каждой строке:
API платежных систем
Провести платеж абоненту на 100р по номеру договора (можно так же подставить логин или IP-адрес) BILL0000003 от имени оператора SBERBANK_OSMP, ID платежа 100
API 1С
API личного кабинета
Работает только с разрешенного IP
Ошибка Context=$x is not defined
При запросах к api возвращается ошибка, например:
Добавить необходимый context в /app/asr_billing/cfg/config в параметр network[‘api.context’]
И перезапустить (/app/asr_billing/service restart) биллинг, чтобы изменения применились.
Отладка
API-запросы и ошибки их выполнения логируются в следующие файлы:
По-умолчанию, уровень логирования установлен в error. Для того, чтобы логировать все запросы, установите в конфигурационном файле /app/asr_billing/cfg/config уровень логирования django в info:
По окончанию отладки, рекомендуется вернуть уровень логирования в статус error.
Api работает через порт 8082.
В api можно получить подробные сведения о каждой модели веб-интерфейса администратора Carbon Billing 5.
Создадим тариф с помощью api. Обязательно указываем аргумент, даже если он пустой.
Возвращается XML документ с подробными описаниями для нового объекта.
Можно задать сразу имя тарифа:
В файле можно увидеть, что тариф создался с именем:
Также мы можем получить файл не в XML виде, а в json, для этого пишем в командной строке:
После создания или изменения объекта, его нужно сохранить:
Логика биллинга отработает и вернет значения, которые после сохранения выставились в тарифе.
Теперь этот тариф можно увидеть в веб-интерфейсе администратора Carbon Billing 5.
Чтобы авторизоваться для работы в api, необходимо зайти в веб-интерфейс администратора Carbon Billing 5, раздел Настройки/Настройки (в файле)/Настройка Сети.
Также нужно указать hash_key, который обычно известен при авторизации.
Тогда все запросы будут считаться авторизованными.
Задача: Требуется создавать абонентов с реквизитами.
1.Необходимо узнать имена моделей для составления к ним запросов, для этого заходим в администраторскую панель и нажимаем на соответствующие пункты, чтобы в строке url браузера увидеть название модели.
Некоторые модели можно узнать только через настройку прав доступа.
2.Также необходимо узнать ид реквизитов который хотим добавлять абоненту.
Например мы хотим добавить прописку: 15
3.Создадим группу или используем существующую для новых абонентов и узнаем ее номер для запросов:
Например 90
4.Итак узнав имена моделей (Abonents и AttributeValues), для создания запросов необходимо узнать имена полей который мы хотим заполнять, для этого делаем запросы
соответственно.
5.Имея всю необходимую информацию по абонентам и их реквизитам сначала создаем запрос на создание абонента:
, в ответ мы получим json массив откуда узнаем pk созданного абонента и по нему формируем запрос на создание реквизитов указывая его каждый раз как abonent_id:
6.Мы успешно создали абонента с именем Тест в группе VIP с реквизитом Прописка:Россия
Синтаксис. Диапазон параметров
Если требуется передать диапазон параметров, например при запросе данных, то синтаксис будет такой:
Вообще доступен весь синтаксис django
Авторизация через API
С примером класса авторизации через php можете ознакомиться здесь: https://github.com/carbonsoft/billing_api_tools
Примеры
Пример 1. Внести абоненту с номером договора SL0000001 на счет 500 рублей.
Пример 2. Получить баланс абонента с номером договора BILL0000029.
И берем цифровое значение
Далее вставляем его в запрос:
После этого операция debit-credit+ostatok даст баланс абонента
Пример 3. Получить данные по отчету номер 15 из конструктора отчетов.
Пример 4. Получить данные по отчету номер 15 из конструктора отчетов. если в отчет нужно передать параметры.
Например при запуске отчета выводится 2 поля для заполнения, которые называются «C_даты» и «По_дату»
Пример 5. Получить список учетных записей заблокированных абонентов
| Эта версия API больше не поддерживается. Пожалуйста, используйте API REST v2.0 |
Отличия API REST v1 и v2
Описание API REST v1
Api работает через порт 8082.
В api можно получить подробные сведения о каждой модели веб-интерфейса администратора Carbon Billing 5.
Создадим тариф с помощью api. Обязательно указываем аргумент, даже если он пустой.
Возвращается XML документ с подробными описаниями для нового объекта.
Можно задать сразу имя тарифа:
В файле можно увидеть, что тариф создался с именем:
Также мы можем получить файл не в XML виде, а в json, для этого пишем в командной строке:
После создания или изменения объекта, его нужно сохранить:
Логика биллинга отработает и вернет значения, которые после сохранения выставились в тарифе.
Теперь этот тариф можно увидеть в веб-интерфейсе администратора Carbon Billing 5.
Чтобы авторизоваться для работы в api, необходимо зайти в веб-интерфейс администратора Carbon Billing 5, раздел Настройки/Настройки (в файле)/Настройка Сети.
Также нужно указать hash_key, который обычно известен при авторизации.
Тогда все запросы будут считаться авторизованными.
Задача: Требуется создавать абонентов с реквизитами.
1.Необходимо узнать имена моделей для составления к ним запросов, для этого заходим в администраторскую панель и нажимаем на соответствующие пункты, чтобы в строке url браузера увидеть название модели.
Некоторые модели можно узнать только через настройку прав доступа.
2.Также необходимо узнать ид реквизитов который хотим добавлять абоненту.
Например мы хотим добавить прописку: 15
3.Создадим группу или используем существующую для новых абонентов и узнаем ее номер для запросов:
Например 90
4.Итак узнав имена моделей (Abonents и AttributeValues), для создания запросов необходимо узнать имена полей который мы хотим заполнять, для этого делаем запросы
соответственно.
5.Имея всю необходимую информацию по абонентам и их реквизитам сначала создаем запрос на создание абонента:
, в ответ мы получим json массив откуда узнаем pk созданного абонента и по нему формируем запрос на создание реквизитов указывая его каждый раз как abonent_id:
6.Мы успешно создали абонента с именем Тест в группе VIP с реквизитом Прописка:Россия
Синтаксис. Диапазон параметров
Если требуется передать диапазон параметров, например при запросе данных, то синтаксис будет такой:
Вообще доступен весь синтаксис django
Авторизация через API
С примером класса авторизации через php можете ознакомиться здесь: https://github.com/carbonsoft/billing_api_tools
Примеры
Пример 1. Внести абоненту с номером договора SL0000001 на счет 500 рублей.
Пример 2. Получить все данные абонента с номером договора BILL0000029.
И берем цифровое значение
Далее вставляем его в запрос:
После этого операция debit-credit+ostatok даст баланс абонента
Пример 3. Получить данные по отчету номер 15 из конструктора отчетов.
Пример 4. Получить данные по отчету номер 15 из конструктора отчетов. если в отчет нужно передать параметры.
Например при запуске отчета выводится 2 поля для заполнения, которые называются «C_даты» и «По_дату»
Пример 5. Получить список учетных записей заблокированных абонентов
Carbon Soft
Popular repositories
Установщик системы выгрузки единого реестра запрещённых сайтов и проверки фильтрации трафика проектом Carbon Reductor
Генератор зон для named/bind9/unbound для списка доменов, которые необходимо перекидывать на заглушку
BGP RTBH schemes with reductor as announcer.
OpenCarbon7: utils and helpers for developers. bash_indent bash_syntax etc.
Набор bash скриптов упрощающих жизнь linux-разработчика и не только.
OpenCarbon7: utils and helpers for developers. bash_indent bash_syntax etc.
2 Updated Aug 27, 2021
0 Updated Feb 26, 2021
0 Updated Sep 29, 2020
Несколько тестовых вопросов, которые помогут понять, подходит ли данная вакансия или нет.
0 Updated Aug 5, 2020
Установщик системы выгрузки единого реестра запрещённых сайтов и проверки фильтрации трафика проектом Carbon Reductor
1 Updated Sep 16, 2018
Плагины для отслеживания метрик для Carbon Reductor
0 Updated Mar 28, 2018
Генератор зон для named/bind9/unbound для списка доменов, которые необходимо перекидывать на заглушку
0 Updated Mar 15, 2018
BGP RTBH schemes with reductor as announcer.
0 Updated Feb 9, 2018
Скрипт синхронизации с 1С
0 Updated Jan 30, 2018
Страницы заглушки + конфиги nginx для быстрого развёртывания веб-сервера со страницами-заглушками
0 Updated Jan 29, 2018
People
This organization has no public members. You must be a member to see who’s a part of this organization.
Top languages
Most used topics
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Carbon — простой и функциональный инструмент PHP для работы с датой и временем
Дата публикации: 2018-05-14
От автора: так сложилось, что дата и время повсеместно используются практически на каждом сайте в интернете, причем не просто для отображения на экран, дата и время, как правило, входят в состав различных логических преобразований для формирования контента. Поэтому в данном уроке мы с Вами рассмотрим замечательный инструмент по работе с вышеуказанной информацией под названием Carbon.
Как Вы знаете, в структуре языка PHP, есть довольно функциональный класс, для работы с датой и временем, под названием DateTime. Который отлично справляется с типовыми задачами, но порой его функционала все же не достаточно. То есть хотелось бы иметь в распоряжении больше методов, которые добавляют удобства и легкости в работе с датой и временем. Как раз эту проблему и решает расширение под названием Carbon. По сути – это обычный класс, который расширяет функционал вышеуказанного класса, добавляя к нему множество интересных методов по созданию и преобразованию даты и времени. Официальный сайт, указанного инструмента Вы найдет по ссылке.
Для установки библиотеки с использованием инструмента Composer, достаточно выполнить команду:
Бесплатный курс по PHP программированию
Освойте курс и узнайте, как создать динамичный сайт на PHP и MySQL с полного нуля, используя модель MVC
В курсе 39 уроков | 15 часов видео | исходники для каждого урока