Skip to main content

История изменений 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Сервер → ДронКонвертация модели в TensorRT12.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Сервер → ДронЗапрос параметров ArduPilot15.04.2025
set_drone_paramsСервер → ДронУстановка параметров ArduPilot15.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Дрон → СерверПараметры ArduPilot15.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

Удалённые топики​

  • change_status

v1.0 — 09.12.2024​

Первая версия документа. Описан топик get_mission с полной структурой миссии. Остальные топики заявлены, но не описаны.