任务管理:飞行任务的 CRUD(创建 / 查询 / 编辑 / 删除)、放行预检、挂起 / 解除挂起 / 取消、媒体优先上传、断点续飞。
任务查询:任务列表、按 UUID 批量查询详情、V2 版详情(含执行明细)、当前活动任务、机场最近任务、任务时间冲突列表、飞行轨迹。
AI 飞行告警:按设备 SN 查询有 AI 告警的飞行架次、查询历史 AI 告警记录。
飞行记录 → 导出与下载:导出任务(异步生成 zip)、下载飞行记录单文件。
1.
放行预检(仅立即任务):调用 检查飞行任务阻飞项 (POST /openapi/v2.0/task/api/v1/workspaces/{workspace_id}/flight-tasks/reject-takeoff)。本接口仅接受 task_type=1,其他取值会被服务端以 HTTP 400 + code = 200101(message: "param is invalid")拒绝。返回当前 / 降落机场的天气阻飞结果以及移动部署模式下的 GPS 航线阻飞结果,避免用户提交后才被业务层卡住。
2.
设备能力检查:检查飞行任务是否满足下发条件 (GET /openapi/v2.0/task/api/v1/workspaces/{workspace_id}/flight-tasks/check) — query 参数为 sn(设备 SN,注意 spec 中是 sn 而不是 device_sn)+ wayline_uuid,校验组合是否能成功下发,返回 warning 列表但不阻塞创建。
3.
时间冲突检查(重复 / 定时任务):查询飞行任务时间冲突列表 (POST /openapi/v2.0/task/api/v1/workspaces/{workspace_id}/flight-tasks/conflicts) — 请求体必填 task_type、time_zone、sn 等字段(和创建任务时的时间规则一致),反向查询同一设备 SN 下已有的会发生时间冲突的任务列表。
4.
基础版:创建飞行任务 (POST /openapi/v2.0/task/api/v1/workspaces/{workspace_id}/flight-tasks)。
推荐使用高级版:创建飞行任务(高级版,返回子任务) (POST /openapi/v2.0/task/api/v1/workspaces/{workspace_id}/flight-tasks/advanced) — 业务规则相同,但响应中带回子任务信息(重复 / 连续任务会拆出多个子任务),便于一次拿到完整父子结构。
1.
列表:查询飞行任务列表(V2,支持多维过滤) (GET /openapi/v2.0/task/api/v2/workspaces/{proj_uuid}/flight-tasks) — 支持按任务名、设备 SN 、时间段、任务类型、状态等过滤,按时间倒序分页返回。
2.
V1 详情:获取飞行任务详情 (GET /openapi/v2.0/task/api/v1/workspaces/{workspace_id}/flight-tasks/{task_uuid}) — 含规则、设备、航线、状态、子任务、VLM 配置、断点信息等。
V2 详情(推荐):获取飞行任务详细信息(V2,含执行明细) (GET /openapi/v2.0/task/api/v2/workspaces/{workspace_id}/flight-tasks/detail) — 比 V1 多执行轨迹明细 / 飞行架次列表 / 媒体采集汇总。
3.
批量:按 UUID 批量查询飞行任务详情 (GET /openapi/v2.0/task/api/v1/workspaces/{workspace_id}/flight-tasks/batch) — 适用于前端任务看板批量刷新状态、跨系统状态同步。
4.
机场最近任务:查询机场最近 / 当前任务 (GET /openapi/v2.0/task/api/v1/workspaces/{workspace_id}/flight-tasks/recent) — 优先返回执行中 + 暂停中,其次返回最近一条失败 / 终止;命中缓存直接返回。
5.
任务管理视角:获取当前活动航线任务(任务管理) (GET /openapi/v2.0/task/api/v1/workspaces/{workspace_id}/flight-tasks/in-flight)。
DRC 实时控制视角:获取当前活动航线任务(DRC 实时控制) (GET /openapi/v2.0/drc/api/v2/projects/{prj_id}/flight-tasks/in-flight)。两接口语义一致,按调用上下文选用。
6.
飞行轨迹:获取任务飞行轨迹(V2) (GET /openapi/v2.0/task/api/v2/workspaces/{workspace_id}/flight-tasks/track) — 已结束任务的实际航点经纬度 + 高度 + 时间戳序列,用于轨迹回放。
1.
创建导出任务:导出飞行任务记录(生成 zip 异步任务) (POST /openapi/v2.0/task/api/v2/workspaces/{workspace_id}/flight-tasks/export)。请求体必填字段:flight_task_ids(要导出的任务 UUID 列表)、file_name、file_type、content_type、metrics。
2.
轮询:查询飞行任务导出历史 (GET /openapi/v2.0/task/api/v2/workspaces/{workspace_id}/flight-tasks/export) — status 为整数枚举:0=进行中 / 1=已完成 / 2=失败 / 3=已取消。
3.
下载:飞行记录文件下载 (GET /openapi/v2.0/manage/api/v1/workspaces/{uuid}/flight-tasks/oss-url-info) 按 object_key 换取临时签名 URL。
4.
取消 / 删除:取消 / 删除导出任务 (PUT /openapi/v2.0/task/api/v2/workspaces/{workspace_id}/flight-tasks/export) — 进行中任务可取消(status=0 时),已结束的可删除记录(status=1/2)。