История изменений API Server-Drone
Журнал изменений между версиями API интеграции Server-Drone.
v3.0.17 — 18.11.2026
Изменения топиков
- drone_request_init: поле
public_key необязательное; без открытого ключа дрона сервер не передаёт ему aes_key и обменивается с ним без шифрования
- drone_request_approve:
aes_key передаётся зашифрованным открытым ключом дрона (RSA-OAEP, SHA-256, base64) и есть, только если дрон передал public_key; public_key — открытый ключ сервера; одобрение приходит и на повторный drone_request_init одобренной заявки
- drone_request_complete: сообщение содержит только
drone_id; поля organization_id, public_key, mac_address убраны
Изменения документации
v3.0.16 — 10.11.2026
Новые топики
| Топик | Направление | Описание |
|---|
command_status | Дрон → Сервер | Начало и окончание каждой команды задания версии 2: started / completed / skipped / interrupted |
trigger_fired | Дрон → Сервер | Борт выполнил действие триггера миссии |
Изменения топиков
- mission: два формата задания — версия 1 (без поля
version) и версия 2 (version: 2, команды, параметры и поля миссии под ключами манифестов ПО, запретные зоны, триггеры). Формат выбирается по ПО дрона
- mission (версия 1): добавлено поле
negative_zones, без зон — пустой массив
- mission_cancelled: причины
no_fly_zone, exec_time_exceeded, trigger; поля no_fly_zone_id, trigger_id
- mission_rejected: причины отказа от задания версии 2; поля
command_id, param_key, trigger_id, detail
- payload: блок
software — релизы ПО платформы, запущенные на дроне
- photo, objects_data: необязательные поля
mission_id и command_id
v3.0.15 — 06.11.2026
Новые топики
| Топик | Направление | Описание |
|---|
cancel_rejected | Дрон → Сервер | Отказ борта применить cancel_mission: причина no_active_mission / mission_mismatch / final_landing и ID выполняемой миссии |
Изменения топиков
- cancel_mission: сервер передаёт JSON
{ mission_id, type } — борт останавливает только указанную миссию; строка со способом завершения — только когда ID миссии нет
- mission_cancelled: борт присылает JSON
{ mission_id, reason }, причина operator / battery_low / battery_critical; сервер принимает и прежнюю строку с ID миссии
- data: причину остановки сервер берёт из
reason в mission_cancelled; status_reason используется, только если mission_cancelled пришёл строкой
- mission_aborted: добавлена причина
internal_error — внутренняя ошибка контроллера миссии, текст в detail
v3.0.14 — 22.10.2026
Изменения документации
- create_orthophoto: уточнено назначение url — адрес загрузки архива снимков, а не ссылка на готовый ортофотоплан
- create_orthophoto:
token передаётся без префикса Bearer, пример исправлен
- create_orthophoto_request: вводная фраза больше не обещает дрону готовый ортофотоплан
v3.0.13 — 08.10.2026
Новые топики
| Топик | Направление | Описание |
|---|
mission_rejected | Дрон → Сервер | Отказ дрона во взлёте по миссии: причина battery_low / battery_critical и заряд |
mission_aborted | Дрон → Сервер | Аварийное завершение миссии: причина critical_disarm / fc_emergency |
calibration_result | Дрон → Сервер | Итог процедуры калибровки: исход, mag_fitness, compass_id |
clear_emergency | Сервер → Дрон | Сброс аварийного состояния emergency landing на борту |
Изменения топиков
- data: добавлены поля
battery_status (уровень заряда, по которому действует борт: ok / low / critical / unknown), status_reason (причина returning, landing, emergency landing) и battery_id (ключ применённой записи батареи)
- data:
emergency landing снимается также командой clear_emergency; отказ во взлёте сопровождается mission_rejected, аварийное завершение миссии — mission_aborted
- payload, drone_request_init: в записи
batteries.battery_<index> добавлены cell_count_detected (число ячеек по автоопределению борта) и capacity_mah_fc (значение BATT_CAPACITY полётного контроллера)
- payload: в ответ на каждое сообщение сервер отправляет
asset_config и запрашивает батарейный набор параметров полётного контроллера
- asset_config: публикуется retained и целиком; отправляется в ответ на каждый
payload и при изменении оборудования, характеристик или порогов батареи
- asset_config:
batteries содержит одну запись battery_0 — систему питания дрона: ёмкость суммируется по батареям, число ячеек берётся у одного пакета, поле id больше не передаётся. При расхождении числа ячеек или состава между батареями batteries пустой
- asset_config: в
battery_0 добавлены пороги заряда low_percent (30–99) и critical_percent (15–98, ниже low_percent); при некорректной паре не передаются
- asset_config:
chemical_composition передаётся в написании платформы — liPo, liHv, liIon
- critical_disarm: сервер подписан на топик, фиксирует факт команды и переводит статус работоспособности дрона в
critical
- mission_received: если за 10 секунд не пришли ни
mission_rejected, ни завершение или отмена миссии, а дрон остался online, сервер помечает миссию как не начатую
- get_drone_params: сервер сам запрашивает батарейный набор параметров в ответ на
payload и при выходе дрона на связь после offline или lost
- set_drone_params: сервер сам записывает
BATT_CAPACITY при расхождении с ёмкостью карточки батареи
- drone_params_data: сервер сохраняет батарейный набор параметров и сверяет его с порогами заряда карточки батареи
- calibration_data, mag_fitness: сервер сохраняет шаги и результат процедуры калибровки
Изменения документации
- mag_fitness: исправлено описание
fitness — это невязка подгонки, меньшее значение лучше; ранее было описано как качество от 0 до 1
- data: снята оговорка о том, что отличить отмену оператором от возврата по заряду нельзя, — теперь причину несёт
status_reason
v3.0.12 — 07.10.2026
Новые топики
| Топик | Направление | Описание |
|---|
variables_config | Сервер → Дрон | Конфигурация переменных пинов дрона (retained) |
pin_var_{code} | Сервер → Дрон | Значение выходной переменной пина |
get_variables_config | Дрон → Сервер | Запрос конфигурации переменных пинов |
variables_config_status | Дрон → Сервер | Результат применения конфигурации переменных |
variables_status | Дрон → Сервер | Результат воздействия по переменной пина |
Новая категория
- Добавлена категория Переменные пинов для топиков переменных пинов
Изменения топиков
- data: добавлено необязательное поле
custom — значения переменных пинов (код переменной → значение)
- payload: сервер сохраняет
flight_controller.model у дрона и при смене модели бортового компьютера или полётного контроллера пересылает variables_config
- drone_request_init: при одобрении заявки сервер сохраняет модель полётного контроллера и отправляет дрону первую
variables_config
Переименования
- drone_request_init: объект
assets заменён объектом payload со структурой топика payload. Внутрь payload перенесены firmware, connectivity, а также software и arm_device_id; камеры, батареи и сервоприводы передаются в cameras, batteries, servos, как в payload. Сервер принимает такой формат с 14.08.2026 — документация приведена в соответствие
v3.0.11 — 14.09.2026
Изменения топиков
- data: добавлены поля
battery_voltage (напряжение батареи, В), time_remaining_s (оценка остатка полётного времени, с), flight_mode (фактический режим полётного контроллера ArduPilot) и armed (моторы взведены); battery_level может приходить со значением null
- data: статусы
returning, landing и emergency landing теперь борт выставляет и сам — по порогам заряда и по реакции полётного контроллера на аварию, без команды с платформы. Набор допустимых значений status не изменился
- data: в перечень значений
status добавлено calibration — значение приходило и раньше, но не было описано
Изменения документации
- data: описаны автономные переходы статусов и сопутствующие события
mission_cancelled / mission_completed; отмечено, что отличить отмену миссии оператором от возврата по заряду средствами API нельзя
- mission_received: отказ во взлёте из-за низкого заряда не сопровождается ни
mission_completed, ни mission_cancelled — подтверждение получения миссии не гарантирует взлёта
v3.0.10 — 14.09.2026
Изменения топиков
- update_software_status: добавлено поле
reason (причина неудачи, сохраняется в software_installation.error_message); поля version и software_release_id больше не помечены обязательными — version обязательна только при status: ok, software_release_id сервером не используется
Изменения документации
- update_software_status: топик описан как результат обновления ПО — и успешное завершение, и неудача (ранее — только подтверждение успеха)
v3.0.9 — 21.07.2026
Изменения топиков
- drone_request_init: поля
flight_controller (полетный контроллер) и board_computer (бортовой компьютер) перенесены внутрь объекта assets
v3.0.8 — 11.06.2026
Новые топики
| Топик | Направление | Описание |
|---|
update_software | Сервер → Дрон | Команда обновления программного обеспечения на дроне |
update_software_status | Дрон → Сервер | Подтверждение завершения обновления ПО |
Новая категория
- Добавлена категория ПО для топиков обновления программного обеспечения
v3.0.7 — 05.06.2026
Изменения документации
- payload: уточнены допустимые значения полей камер —
connection_type ("usb", "ethernet"), distortion_model ("barrel", "pincushion", "tangential", "thin_prism")
- drone_request_init: уточнены допустимые значения полей камер —
connection_type ("usb", "ethernet"), distortion_model ("barrel", "pincushion", "tangential", "thin_prism")
v3.0.6 — 27.05.2026
Новые топики
| Топик | Направление | Описание |
|---|
asset_config | Сервер → Дрон | Конфигурация аппаратных компонентов дрона (камеры, SD-карта, батареи, сервоприводы) |
Изменения топиков
- drone_request_init: добавлены поля
assets, flight_controller, board_computer, firmware, connectivity
- payload: реструктуризация полей —
cameras переименованы ключи с main_camera на camera_<index>, поля камер заменены (id, model, serial_number, connection_type, distortion_model вместо resolution, gimbal, zoom); sd_card заменён на объект с UUID и расширенными полями; добавлены batteries и servos; добавлен board_computer; connectivity дополнен signal_level
v3.0.5 — 08.05.2026
Переименования
- data (Дрон → Сервер): поле
use_ai_video переименовано в tracker
- data (Дрон → Сервер): поле
camera_tracking переименовано в tracker_camera
- mission (Сервер → Дрон): поле
use_ai_video в командах переименовано в tracker
- Топик
use_ai_video (Сервер → Дрон) переименован в tracker
Изменения топиков
- mission: добавлено поле
tracker_camera в команды (камера для AI-трекинга объектов)
v3.0.4 — 30.04.2026
Новые топики
| Топик | Направление | Описание |
|---|
lep_control | Сервер → Дрон | Управление полётом вдоль ЛЭП и инспекцией столбов (постановка, полёт, запрос статуса) |
lep_status | Дрон → Сервер | Агрегированный статус режима ЛЭП (полёт, инспекция, постановка) |
Новая категория
- Добавлена категория ЛЭП для топиков управления полётом вдоль линий электропередач и инспекции столбов
v3.0.3 — 08.04.2026
Новые топики
| Топик | Направление | Описание |
|---|
send_audio_link | Сервер → Дрон | Отправка аудиофайла для голосового пайплайна робота |
download_audio_info | Дрон → Сервер | Прогресс и статус загрузки аудио |
STT_result | Дрон → Сервер | Результат распознавания речи (Whisper) |
LLM_answer | Дрон → Сервер | Ответ языковой модели (Qwen) |
Новая категория
- Добавлена категория Робот для топиков голосового пайплайна
v3.0.2 — 23.03.2026
Изменения топиков
- transferring_info: добавлено поле
progress_percent (процент выполнения конвертации)
v3.0.1 — 17.03.2026
Изменения топиков
- download_info: добавлен статус
none (загрузка не начата)
- get_current_data: добавлены подписанные модули:
gimbal_data, drone_strike_status, drone_follow_status, actual_objects_data, download_info, transferring_info, current_model_tracking
v3.0 — 19.02.2026
Новые топики
| Топик | Направление | Описание |
|---|
sim_gps | Сервер → Дрон | Симуляция GPS-координат для тестирования |
create_orthophoto | Сервер → Дрон | Ответ на запрос ортофотоплана (URL + токен) |
ardupilot_status | Дрон → Сервер | Статусные сообщения ArduPilot (severity + message) |
create_orthophoto_request | Дрон → Сервер | Запрос дрона на создание ортофотоплана |
Изменения топиков
- mission:
command_type добавлен список доступных команд; добавлены поля speed, conf, rec_video_drone, rec_video_dist_threshold, obstacle_avoidance, use_ai_video, orthophoto, orthophoto_camera в команды
- gimbal_control: формат зума изменён с строки на число (
0/1+ вместо "0"/"1" - максимальный зум задается характеристиками камеры)
- send_file_link: добавлено поле
classes_file_link (URL файла классов или null)
- transferring_to_tensorRT: добавлены статусы
start (начать конвертацию) и stop (остановить конвертацию)
- transferring_info: добавлен статус
stopped (конвертация отменена)
Формат документации
- Документация приведена в новый формат с компонентами
ApiSchema/Field
- Удалены все ссылки на внутренние ROS-топики из документации
- Каждая версия содержит полный список топиков (а не только дельту от предыдущей)
v2.2 — 12.08.2025
Новые топики
| Топик | Направление | Описание | Дата |
|---|
transferring_to_tensorRT | Сервер → Дрон | Конвертация модели в TensorRT | 12.08.2025 |
transferring_info | Дрон → Сервер | Статус конвертации модели | 12.08.2025 |
actual_objects_data | Дрон → Сервер | Список актуально детектируемых объектов | 14.08.2025 |
drop_servo | Сервер → Дрон | Сброс сервопривода | 01.09.2025 |
registration_check_result | Сервер → Дрон | Результат проверки регистрации дрона | 25.11.2025 |
check_registration | Дрон → Сервер | Запрос проверки регистрации дрона | 25.11.2025 |
Изменения топиков
- mission: обновлена структура для поддержки
drop_servo (01.09.2025)
v2.1 — 12.02.2025
Изменения
- mission_on_pause удалён; вместо него добавлено поле
pause в data
- gimbal_control: формат изменён с массива
[pitch,roll,yaw,zoom] на JSON {camera_id: {roll, pitch, yaw, zoom}}
- Gimbal переименован в gimbal_data
- data: добавлены поля
pause, obstacle_avoidance, camera_tracking
- status в data: обновлена модель статусов —
online, offline, emergency landing, on mission, returning, taking off, landing, paused
Новые топики
| Топик | Направление | Описание | Дата |
|---|
obstacle_avoidance | Сервер → Дрон | Обход препятствий | 26.02.2025 |
get_current_data | Сервер → Дрон | Запрос текущего состояния | 07.03.2025 |
camera_tracking | Сервер → Дрон | Выбор камеры трекинга | 25.04.2025 |
stream_url | Сервер → Дрон | URL видеопотока | 04.04.2025 |
get_calibration_data | Сервер → Дрон | Запрос калибровки | 04.04.2025 |
set_calibration | Сервер → Дрон | Установка калибровки | 04.04.2025 |
get_check_motors | Сервер → Дрон | Запрос проверки моторов | 04.04.2025 |
set_check_motors | Сервер → Дрон | Управление моторами | 04.04.2025 |
get_drone_params | Сервер → Дрон | Запрос параметров ArduPilot | 15.04.2025 |
set_drone_params | Сервер → Дрон | Установка параметров ArduPilot | 15.04.2025 |
drone_request_approve | Сервер → Дрон | Подтверждение регистрации | 16.05.2025 |
send_file_link | Сервер → Дрон | Загрузка ML-модели | 23.05.2025 |
set_model_name | Сервер → Дрон | Установка активной модели | 23.05.2025 |
delete_model | Сервер → Дрон | Удаление модели | 23.05.2025 |
gimbal_auto_control | Сервер → Дрон | Автосканирование подвеса | 11.06.2025 |
follow_track_object | Сервер → Дрон | Слежение камеры за объектом | 25.06.2025 |
drone_follow_object | Сервер → Дрон | Следование дрона за объектом | 22.07.2025 |
drone_strike_object | Сервер → Дрон | Таран объекта | 22.07.2025 |
gimbal_data | Дрон → Сервер | Данные подвеса камеры | 07.03.2025 |
gimbal_auto_status | Дрон → Сервер | Статус автосканирования | 11.06.2025 |
drone_params_data | Дрон → Сервер | Параметры ArduPilot | 15.04.2025 |
calibration_data | Дрон → Сервер | Данные калибровки | 04.04.2025 |
check_motors_data | Дрон → Сервер | Данные моторов | 04.04.2025 |
stream_lost | Дрон → Сервер | Потеря видеопотока | 15.04.2025 |
payload | Дрон → Сервер | Статус оборудования | 15.04.2025 |
mag_fitness | Дрон → Сервер | Калибровка магнитометра | 16.05.2025 |
drone_request_init | Дрон → Сервер | Инициация регистрации | 16.05.2025 |
drone_request_complete | Дрон → Сервер | Завершение регистрации | 16.05.2025 |
follow_info_publisher | Дрон → Сервер | Информация о трекинге | 25.06.2025 |
drone_follow_status | Дрон → Сервер | Статус следования | 22.07.2025 |
drone_strike_status | Дрон → Сервер | Статус тарана | 22.07.2025 |
download_info | Дрон → Сервер | Прогресс загрузки модели | 23.05.2025 |
current_model_tracking | Дрон → Сервер | Текущая модель трекинга | 23.05.2025 |
result_delete | Дрон → Сервер | Результат удаления модели | 23.05.2025 |
v2.0 — 19.12.2024
Изменения
- get_mission переименован в mission
- critical_disarm: сообщение изменено с пустого на
"true"
Новые топики
| Топик | Направление | Описание |
|---|
use_hand_mode | Сервер → Дрон | Ручной/автоматический режим |
use_ai_video | Сервер → Дрон | AI-детекция |
gimbal_control | Сервер → Дрон | Управление подвесом (массив) |
joy_control | Сервер → Дрон | Ручное управление |
critical_disarm | Сервер → Дрон | Экстренное отключение |
mission_completed | Дрон → Сервер | Завершение миссии |
mission_received | Дрон → Сервер | Получение миссии |
mission_cancelled | Дрон → Сервер | Отмена миссии |
mission_on_pause | Дрон → Сервер | Пауза миссии |
Удалённые топики
change_status (удалён в v1.1)
v1.1 — 17.12.2024
Изменения
- Добавлены описания топиков:
cancel_mission, change_realtime_stream, pause_mission, data, objects_data, photo
- В
get_mission добавлены проверки параметра triggers (допустимые символы)
- Добавлен тип данных Position
- Раздел «Дрон → Сервер» переведён с HTTP POST на MQTT
Удалённые топики
v1.0 — 09.12.2024
Первая версия документа. Описан топик get_mission с полной структурой миссии. Остальные топики заявлены, но не описаны.