Делимся главным о 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
Комплекс Алиссум-ВН предназначен для сканирования радиочастотной обстановки, выявления излучения БПЛА и классификации типов излучаемых сигналов. Периодичность запросов определяется временем сканирования и анализа всего рабочего диапазона частот (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