执行航线任务 API 调用指南
场景介绍
您可以通过司空2 OpenAPI实现无人机飞行器执行您下发的航线任务，具体包括：在「项目」中选择具体的飞行器设备和需要执行的具体的航线 设置任务参数后给DJI Dock设备创建并下发一个航线任务 飞行器执行航线任务 航线任务执行过程中，获取飞行控制权并下发飞行指令（可选） 航线任务执行成功后，获取航线任务的飞行轨迹、飞行记录以及媒体成果列表。
前置步骤
前置项 | 描述 |
|---|---|
| 账号权限 | 在司空2获得OpenAPI「组织秘钥」，并且已具有对应项目（proj_uuid）和设备控制的权限 |
| 设备要求 | 司空2对应项目下已接入无人机 + 机场设备 |
| 网络要求 | 设备与司空2云端保持在线，第三方系统需要与司空2服务端保持网络通畅 |
使用到的OpenAPI列表
| API | 说明 |
|---|---|
获取项目列表 GET /openapi/v0.9/manage/api/v1/organizations/{org_uuid}/projects | 获取指定组织下的项目列表，支持分页和筛选 |
获取项目团队设备列表GET/openapi/v0.9/manage/api/v1/projects/{proj_uuid}/topologies | 获取项目中的设备信息，包括设备状态、设备拓扑关系等 |
获取Web端航线列表GET /openapi/v0.9/wayline/api/v1/workspaces/{proj_uuid}/web-waylines | 获取指定项目中航线库的航线列表 |
获取航线详情GET /openapi/v0.9/wayline/api/v1/workspaces/{proj_uuid}/waylines/{id} | 获取指定航线的详细信息 |
创建航线任务POST /openapi/v0.9/task/api/v1/workspaces/{proj_uuid}/flight-tasks | 创建新的飞行任务，支持立即任务、重复任务、定时任务和连续任务 |
获取云控权限POST/openapi/v0.9/drc/api/v1/projects/{proj_uuid}/cloud_controls | 获取指定无人机设备的特定云控权限 |
发送飞行控制指令POST /openapi/v0.9/manage/api/v1/projects/{proj_uuid}/flight-commands | 向指定设备发送飞行控制指令 |
获取航线任务列表GET /openapi/v0.9/task/api/v2/workspaces/{proj_uuid}/flight-tasks | 查询飞行任务列表 |
获取航线任务的飞行记录GET /openapi/v0.9/task/api/v2/workspaces/{proj_uuid}/flight-tasks/detail | 获取飞行任务的详细信息如任务状态、飞行记录、媒体成果文件夹id等 |
获取航线任务飞行轨迹 GET /openapi/v0.9/task/api/v1/workspaces/{proj_uuid}/flight-tasks/track | 获取航线任务飞行轨迹信息 |
获取媒体文件列表 GET /openapi/v0.9/media/api/v1/workspaces/{proj_uuid}/files | 查询媒体文件列表 |
操作时序图（Mermaid UML）
常见问题
修改于 2025-07-18 07:06:54