Универсальное API

Совместно с разработчиками ряда биллингов было создана структура универсального API, которое позволяет удобно и стандартизировано получать информацию из различных биллинговых систем.

С документом можно ознакомится по ссылке http://userside.eu/main/files/API_Billing_v1_2.docx

Текущая версия: 1.2 от 25.10.2015

На данный момент работу по этому API поддерживают биллинги:

• uBilling v.0.7.2+
• MikBill v.2.8.16+
• также в самой ERP "UserSide" поддерживается вывод информации по требованиям этого API

Вводные

1. Всё взаимодействие построено на API RESTful-запросах

2. Рабочая кодировка – UTF-8

3. Формат данных с ответами – JSON

4. Дата выводится в формате «ГГГГ-ММ-ДД чч:мм:сс»

5. В качестве идентификации используется API-ключ

6. Дополнительно рекомендуется на уровне API биллинга настраивать и проверять IP-адрес хоста, откуда поступают запросы либо ограничивать доступ vlan`ами

7. На не поддерживаемые методы (или методы без необходимых параметров) необходимо отвечать HTTP-400 статусом через header. В тексте 400-ответа можно расширенно отвечать о характере ошибки.

8. Текстовые поля, которые имеют пустое значение – рекомендуется не возвращать вовсе (для экономии трафика)

Поддерживаемые методы

(с полным описанием можно ознакомиться в документе по ссылке выше. Здесь же методы представлены лишь для общего информирования и с примерами)

1. Тарифные планы. Стандартные тарифы

Запрос:
api.php?key=apikey&request=get_tariff_list

Результат:
http://userside.eu/userside/api.php?key=key&cat=module&request=get_tariff_list

2. Населённые пункты

Запрос:
?key=apikey&request=get_city_list

Результат:
http://userside.eu/userside/api.php?key=key&cat=module&request=get_city_list

3. Районы в населённых пунктах (если есть)

Запрос:
?key=apikey&request=get_city_district_list

Результат:
http://userside.eu/userside/api.php?key=key&cat=module&request=get_city_district_list

4. Улицы

Запрос:
?key=apikey&request=get_street_list

Результат:
http://userside.eu/userside/api.php?key=key&cat=module&request=get_street_list

5. Дома

Запрос:
?key=apikey&request=get_house_list

Результат:
http://userside.eu/userside/api.php?key=key&cat=module&request=get_house_list