Начиная с версии 1.4 система WNAM обеспечивает взаимодействие с внешними системами, которые могут обращаться к серверу системы WNAM через HTTP ReST интерфейс и запрашивать или модифицировать некоторые данные, а также управлять авторизацией пользователей при работе метода авторизации "Через внешнюю систему". Этот механизм полезен для интеграции с внешними системами рекламы, отчетности, CRM, в частности при работе с нотификациями.
API включается в меню "Конфигурация" → "Общие настройки".
Для контроля того, с каких IP-адресов допустимы обращения, применяется параметр allowed_subnets конфигурационного файла /etc/wnam.properties. Доступно два режима работы API.
1.Взаимодействие с внешней системой, осуществляющей идентификацию и взаимодействие с абонентами
В этом режиме система WNAM производит хранение, обработку правил доступа, взаимодействие с RADIUS-клиентами, создает отчетность и обеспечивает розыск. Внешняя система производит идентификацию абонента и сообщает системе WNAM необходимую информацию (учетные записи пользователей). Пользовательский интерфейс абонента обеспечивается внешней системой.
2. Взаимодействие с внешней системой, осуществляющей аналитические функции и дополнительное управление абонентами
В этом режиме система WNAM обеспечивает все действия, связанные идентификацией абонента, сбором статистических данных, отображением страниц и т.п., а внешняя система отвечает за создание и модификацию записей об абонентах, площадках, серверах доступа, веб-интерфейсах пользователей и имеет возможность запрашивать сведения из БД системы WNAM посредством HTTP API интерфейса.
3. Авторизация в API
Для авторизации в API нужно установить параметры в Дополнительных настройках api_token = true, и если нужно api_token_lifetime.
Параметры api_key, api_sign являются устаревшими и они должны выключены api_sign = false. Также не нужно устанавливать параметр sign в запросах.
Для вызовов методов нужно создать пользователя с ролью Администратор API, меню Пользователи интерфейса.
Доступные методы можно посмотреть в swagger по ссылке /swagger-ui/index.html.
Получить токен можно в методе /api/token/authenticate.
Для работы с API следует обратиться на почтовый адрес (обратитесь) к разработчикам ООО "Нетамс".