司空云端互联
  1. 任务下发
司空云端互联
  • 司空API
    • 司空Webhook
    • 环境说明
    • 错误码
    • 码流转发
      • 码流转发流程图
      • 开始码流转发
      • 关闭码流转发
      • 获取码流转发频道转码器
    • 任务下发
      • 获取项目航线文件列表
        GET
      • 创建任务
        POST
      • 航线任务执行中指令下发
        POST
      • 航线任务轨迹获取
        GET
      • 项目设备拓扑
        GET
      • 获取任务详情
        GET
    • 获取组织下的项目列表
      GET
    • 获取指定项目的设备列表
      GET
    • 发布通知及创建地图元素
      POST
    • 获取项目临时上传凭证
      POST
    • 航线上传通知
      POST
    • 获取生成文件信息及下载地址
      GET
  1. 任务下发

获取任务详情

GET
/task/api/v1.0/projects/{project_uuid}/flight-tasks/{task_uuid}

请求参数

Path 参数
project_uuid
string 
项目uuid
必需
示例值:
{{project_uuid}}
task_uuid
string 
必需
任务uuid(调用“创建任务”接口时,如果创建成功,系统会返回任务uuid)
示例值:
1dc16944-a82f-47ec-bfde-205781a8f6b1
Header 参数
X-Organization-Key
string 
组织密钥
必需
示例值:
{{organization_key}}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request GET '/task/api/v1.0/projects/{{project_uuid}}/flight-tasks/1dc16944-a82f-47ec-bfde-205781a8f6b1' \
--header 'X-Organization-Key: {{organization_key}}' \
--header 'X-Organization-Key;'

返回响应

🟢200成功
application/json
Body
code
integer 
非0代表异常
必需
message
string 
消息提示
必需
data
object 
必需
name
string 
任务名称
必需
uuid
string 
任务uuid
必需
task_type
enum<integer> 
任务类型
必需
枚举值:
1234567
status
enum<integer> 
必需
0: 待开始 1: 启动失败 2:执行中 3:已暂停 4:终止 5:成功 6:挂起 7:超时 8:部分执行 9:准备中
枚举值:
012345689
sn
string 
机场sn
必需
landing_dock_sn
string 
必需
计划降落的机场sn,非蛙跳任务为空
wayline_uuid
string 
航线uuid
必需
begin_at
string 
任务计划执行时间
必需
extended_begin_at
null 
必需
固定为null,可忽略
continuous_task_periods
null 
必需
固定为null,可忽略
end_at
string 
任务计划结束时间
必需
repeat_type
integer 
固定为0,可忽略
必需
默认值:
0
interval
integer 
固定为0,可忽略
必需
dow
null 
必需
固定为null,可忽略
dom
null 
必需
固定为null,可忽略
wom
integer 
固定为0,可忽略
必需
out_of_control_action_in_flight
integer 
航线失控动作
必需
rth_altitude
integer 
返航高度
必需
rth_mode
enum<integer> 
返航模式
必需
枚举值:
01
min_battery_capacity
integer 
必需
断点续飞或连续任务的起飞电量
resumable_status
enum<string> 
续飞状态
必需
枚举值:
automanual
wayline_precision_type
enum<integer> 
任务精度类型
必需
枚举值:
01
tags
array[string]
设备直传任务标签
必需
cloud_to_cloud_id
string 
必需
打开设备媒体直传功能后,此处会有一个表示第三方云的ID,无实际用处
exceptions
array [object {9}] 
任务异常
必需
示例
{
  "code": 0,
  "message": "success",
  "data": {
    "name": "新建计划",
    "uuid": "459268e4-82bf-485a-b02d-48c6a99a5abc",
    "task_type": 1,
    "status": 4,
    "sn": "7CTDL000000000",
    "landing_dock_sn": "",
    "wayline_uuid": "65d7e611-d0fd-4b96-8466-e7018bca7af3",
    "begin_at": "2023-12-20T07:41:52.206474Z",
    "extended_begin_at": null,
    "continuous_task_periods": null,
    "end_at": "2023-12-20T07:43:32.206475Z",
    "repeat_type": 0,
    "interval": 0,
    "dow": null,
    "dom": null,
    "wom": 0,
    "out_of_control_action_in_flight": 1,
    "rth_altitude": 90,
    "rth_mode": 1,
    "min_battery_capacity": 0,
    "resumable_status": "manual",
    "wayline_precision_type": 1,
    "tags": [],
    "cloud_to_cloud_id": "220ea3f3-5b3b-4425-8dd2-7e1c91079d16"
  }
}
🟠401401
上一页
项目设备拓扑
下一页
获取组织下的项目列表
Built with