Делимся главным о REST API комплекса Алиссум-ВН 🪁Комплекс Алиссум-ВН предназначен для сканирования радиочастотной обстановки, выявления излучения БПЛА и классификации типов излучаемых сигналов. Периодичность запросов определяется временем сканирования и анализа всего рабочего диапазона частот (300 - 8000МГц) обнаружителя.
Что приходит в каждом запросе?Каждый запрос содержит JSON-объект типа
SCAN_RESULT — полный срез радиочастотной обстановки на момент сканирования - частоты, уровни и типы обнаруженных сигналов.
Классификация сигнала принимает пять значений: NONE — ничего не обнаружено или сигнал не опознан
FPV — аналоговая видеопередача (FPV БПЛА)
DIG — цифровое видео (например БПЛА DJI/Autel)
WIFI — сигналы WiFi
BLOCK — заблокированная «своя» частота.
Форматы запросовУстройство поддерживает три варианта, которые настраиваются через веб-интерфейс -
POST,
POST_BODY, -
GET.
JQ-скрипт предобработкиПеред отправкой на внешний сервер Алиссум-ВН позволяет преобразовать исходный JSON через
JQ-скрипт — прямо в веб-интерфейсе устройства. Это удобно, когда вашему серверу нужен не весь массив из нескольких сотен частот, а только те, где что-то обнаружено.
TCP и UDPПомимо REST API, Алиссум-ВН может отправлять данные по TCP и UDP — устройство в обоих случаях выступает клиентом и шлёт тот же JSON.
По TCP при каждой передаче сообщения открывается отдельное соединение — данные гарантированно дойдут целиком. По UDP полезная нагрузка ограничена MTU сети.
Способы доставки JSON сообщений от внешнего сервера к Алиссум-ВНПередать команду устройству можно
двумя способами.
Первый — отправить GET-запрос напрямую на внутренний сервер устройства по его адресу. НТТР ответ от Алиссум-ВН будет содержать в теле ответный JSON. Метод подходит, если устройство и сервер находятся в защищённой сети без NAT, а внешняя система умеет работать одновременно и как HTTP-клиент, и как HTTP-сервер.
Второй — формирование ответного JSON-сообщения на запрос Алиссум-ВН с радиочастотной обстановкой. Алиссум-ВН периодически шлёт SCAN_RESULT на сервер.
Основные команды управления- управление питанием
- получение или установка конфигурации
- управление "своими" частотами
- управление режимом точного определения частоты
- синхронизация часов реального времени
При работе через открытую сеть — только HTTPS с валидным сертификатом. Передавайте секретный ключ в пользовательском заголовке запроса и проверяйте его на стороне сервера. Без этих мер нет гарантии обеспечения информационной безопасности
❗️Алиссум-ВН 🪁 готовое решение для встраивания в любые системы и комплексы, интеграция занимает минимальное время.
Всем партнерам предоставляем подробное описание REST API, а также техническую поддержку.
Команда Квадро код
🪁https://t.me/quadro_code