cloud_controls 路径与 DRC 角色路径。flight / payload_{index}),否则会返回 228430 / 228431 类错误。topologies/cmds(设备运维 / 通用指令)与 drc/api(DRC 实时控制 / 控制权 / 双工通道),不要混用。tid 等异步标识,真实结果通过指令进度查询接口或 WebSocket 推 送获取,不要假设同步完成。| 路径形态 | 适用场景 |
|---|---|
/projects/{uuid}/topologies/cmds/control(项目维度) | 项目作业人员协同操作(申请 / 同意 / 拒绝 / 释放) |
/projects/{uuid}/drc/roles(DRC 角色) | 直接占用「云控角色」 |
/drc/api/v1/projects/{uuid}/cloud_controls | 直接占用 / 释放云控权限,按 control_keys 粒度 |
/organizations/{uuid}/manage-devices/cmds/control(组织运维) | 运维管理员对组织设备的控制权操作 |
批量查询飞行器云控权状态 (GET /openapi/v2.0/drc/api/v1/projects/{uuid}/cloud_controls),按 SN 列表批量查(单次最多 50 个 SN)。获取(占用)云控权限 (POST /openapi/v2.0/drc/api/v1/projects/{uuid}/cloud_controls)。请求体使用 drone_sn(飞行器 SN)+ control_keys(控制权 key 列表),key 模式为 flight 或 payload_{负载索引}(如 payload_53-0-0,索引格式与设备物模型 camera 字段一致)。无需遥控器同意。释放云控权限 (DELETE /openapi/v2.0/drc/api/v1/projects/{uuid}/cloud_controls)。申请云控授权(向遥控器发起) (POST /openapi/v2.0/drc/api/v1/projects/{uuid}/cloud_control_auth):立即返回 bid,结果通过设备侧异步回调推送。设备控制权操作 (POST /openapi/v2.0/manage/api/v1/projects/{uuid}/topologies/cmds/control):6 种动作(申请 / 抢占队列 / 取消 / 同意 / 拒绝 / 释放)。查询项目设备控制权状态 (GET /openapi/v2.0/manage/api/v1/projects/{proj_uuid}/topologies/cmds/control/status)。查询设备最近正在操作的项目内用户列表 (GET /openapi/v2.0/manage/api/v1/projects/{proj_uuid}/topologies/cmds/operation-users) — 看板 / 协同视图查询多设备的活跃操作者。POST /openapi/v2.0/manage/api/v1/organizations/{uuid}/manage-devices/cmds/control + GET /openapi/v2.0/manage/api/v1/organizations/{uuid}/manage-devices/cmds/control/status。获取(占用)云控角色 (POST /openapi/v2.0/manage/api/v1/projects/{uuid}/drc/roles) — 用于占用 flight_control / payload_control 等角色,占用成功后所有相关用户立即收到 WebSocket 实时变更通知。下发飞行控制指令 (POST /openapi/v2.0/manage/api/v1/projects/{uuid}/flight-commands),body 中传 device_sn(必填)、device_cmd_method(必填,指令名)、device_cmd_data(可选,指令参数对象)。指令的具体 device_cmd_method 名与 device_cmd_data 结构由飞行器机型物模型决定,以飞行器 SDK 文档为准,服务端透传不做枚举校验。查询项目内设备命令执行进度 (GET /openapi/v2.0/manage/api/v1/projects/{proj_uuid}/topologies/cmds)。组织维度的批量进度查询接口(GET /openapi/v2.0/manage/api/v1/organizations/{uuid}/manage-devices/cmds)spec 现归类于「设备管理」模块,详见 设备管理教程。获取飞行任务的设备推荐结果 (POST /openapi/v2.0/task/api/v1/workspaces/{workspace_id}/flight-tasks/device-recommendation),按业务场景(指点飞行 / 普通航线起飞 / 蛙跳航线 / 双机接力 / 基站推荐 / 接处警等 8 类策略)+ 起 / 终点位置反推可用「机场+飞行器」组合。飞向目标点(一键起飞) (POST /openapi/v2.0/task/api/v1/workspaces/{workspace_id}/flight-tasks/drone-take-off)。请求体常用字段:device_sn、target_latitude、target_longitude、target_height、takeoff_mode、security_takeoff_height、max_speed、out_of_control_action