Доступно с версии 0.84

Рекомендуемая минимальная версия для использования 0.93

Возможности

• Тестирование
• Логирование
• USER API
• ADMIN API

Общая информация

Подключение

$conf{API_ENABLE} = 1;

Конфигурация

В системе реализован RESTful интерфейс управления услугами и абонентами. Интерфейс находит по адресу /api.cgi.
Отправка, получение данных производится по протоколу HTTP POST/GET/PUT/DELETE. Все взаимодействие по интерфейсу выполняется по принципам REST (ресурс определяться по средствам задания имени в URL).

Для сохранение совместимости с стандартом REST все ключи автоматически переводятся в camelCase, но поскольку несоответствие названий в базе данных может усложнить разработку – существует возможность отключить такое превращение используя несколько вариантов:

1. Параметр $conf{API_FILDS_CAMELIZE} в конфигурационном файле
2. Задать в заголовках запроса CAMELIZE в соответствующие значение (имеет приоритет над значением в конфигурационном файле)

Сделать ограничение на Admin RESTful API, можно с помощью опции $conf{API_IPS}, в конфигурационном файле config.pl, пример

$conf{API_IPS} = '192.20.208.1, 217.116.76.0/24, 104.81.60.171';

Или в настройках Настройка>Администраторы>Доступ

Возвращать по почту письма, смс или другие вещи которые поддерживают перевод в RESTful API, можно включить с помощью опции $conf{API_CONF_LANGUAGE}, в конфигурационном файле config.pl, пример

$conf{API_CONF_LANGUAGE} = 1;

Авторизация

Для подтверждения личности при выполнении запросов, некоторые пути требуют соответствующий привилегии:

• Авторизация администратора выполняется через API_KEY. Ключ нужно передать в заголовке запроса KEY в значении API_KEY.
  Для получения API_KEY нужно его задать через веб-интерфейс Настройки > Администраторы, поле API_KEY.
  
• Пользователям нужно использовать идентификатор сессии (sid), передавая его значение в заголовке USERSID. 
  Для получения sid можно воспользоваться авторизацией через API используя маршрут авторизация абонента (/users/login).

Запуск на nginx

Чтобы включить поддержку nginx нужно:

• прописать в config.pl опцию

  Code Block
  $conf{API_NGINX}=1;

  
  

• Отредактировать ваш конфигурационный файл nginx