API

Этот раздел описывает возможности использования встроенного API в ERP "UserSide", что позволяет использовать встроенный функционал в собственных проектах.

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

Принцип работы

За взаимодействие отвечает файл /api.php

Можно использовать и GET и POST запросы.

Входящие параметры:
Обязательные:
 key - ключ API
 cat - категория запроса
Прочие дополнительные параметры, в зависимости от категории (см. ниже в соответствующих категориях). Например:
 usercode - id абонента
 is_potential - флаг. Может принимать значение 1 или 0. Большинство флагов имеют префикс is.

Пример запроса:
api.php?key=apikey&cat=abon&subcat=msg&usercode=1

Возвращаемые данные:
 Если запрос предполагает какое-то действие или возврат информации, то в формате JSON будет возвращена информация:
  array(
   [Result] => OK / ERROR
   [ErrorText] => В случае ошибки - текст ошибки
  )

Основная настройка

В основном файле конфигурации main/config/config.php добавьте (или настройте) переменную $zapikey, где укажите свой произвольный API-ключ.

Категории

address - Адреса
attach - Прикрепляемые файлы
additional_data - Дополнительные поля/данные для объектов
advertising - Рекламные кампании
cable_route - Кабельные трассы и каналы
commutation - Коммутация объектов
cross - ODF/Кроссы
customer - Абоненты. Большинство действий актуально для ручных биллингов
device - Оборудование
fiber - ВОЛС
gps - GPS трекеры
inventory - Склад
key - Ключи
map - Карты покрытия
module - Внешние запросы от модулей
newin - Заявка на подключение
node - Объекты инфраструктуры (узлы связи, муфты, опоры, колодцы)
operator - Операторы системы
owner - Собственники объектов
redirect - Переадресация на карточку объекта по какому-то признаку
service - Дополнительные услуги
setting - Настройка
sms - SMS-сообщения
splitter - Делители/уплотнители
staff - Сотрудники
tariff - Тарифы
task - Задания
vehicle - Автотранспорт