全新司空 2 OpenAPI V1.0
  1. 任务管理
全新司空 2 OpenAPI V1.0
  • 认证鉴权
    • 认证鉴权教程
  • 系统服务
    • 司空公有云接入点信息
    • 查询司空 2 系统状态
      GET
  • 组织项目
    • 组织项目教程
    • 获取组织下的项目列表
      GET
    • 获取组织下的设备列表
      GET
    • 获取项目下的设备列表
      GET
    • 获取项目的存储上传凭证
      GET
    • 添加人员到项目
      PUT
  • 设备管理
    • 设备管理教程
    • 物模型获取
      GET
    • HMS信息获取
      GET
    • 实时控制指令下发
      POST
    • 机场相机切换
      POST
    • 飞行器镜头切换
      POST
    • 控制权获取
      POST
    • 控制权释放
      DELETE
    • 图传清晰度设置
      PUT
    • 自定义网络RTK标定
      POST
    • 指定设备进入中继对频模式(仅支持私有云与中继设备)
      POST
    • 查询中继对频的结果(仅支持私有云与中继设备)
      GET
  • 直播管理
    • 直播管理教程
    • 直播推流
      • 开启直播
    • 旁路推流(仅支持私有云)
      • 码流转发错误码
      • 创建码流转发器
      • 开启/关闭码流转发器
      • 获取码流转码器列表
      • 删除码流转发器
  • 任务管理
    • 任务管理教程
    • 创建飞行任务
      POST
    • 更新飞行任务状态
      PUT
    • 获取飞行任务信息
      GET
    • 获取飞行任务列表
      GET
    • 获取飞行任务产生的媒体资源
      GET
    • 获取飞行任务轨迹信息
      GET
  • 航线管理
    • 航线管理教程
    • 航线上传完成通知
    • 获取项目下的航线列表
    • 获取航线详情
  • 模型管理
    • 模型管理教程
    • 模型重建坐标系
    • 获取项目下的模型列表
    • 模型重建
    • 获取模型详情
  • 标注管理
    • 标注管理教程
    • 创建地图标注
  1. 任务管理

创建飞行任务

开发中
POST
https://es-flight-api-cn.djigate.com/openapi/v0.1/flight-task
创建航线飞行任务,可通过 航线上传完成通知接口获取上传到司空 2 上的航线 UUID,然后调用此接口创建航线任务。

请求参数

Authorization
在 header 添加参数
X-User-Token
示例:
X-User-Token: ********************
Header 参数
X-Request-Id
string <uuid>
请求唯一标识
必需
默认值:
{{$string.uuid}}
X-Language
enum<string> 
可选
枚举值:
zhen
默认值:
zh
X-Project-Uuid
string 
项目编号
可选
默认值:
{{X-Project-Uuid}}
X-User-Token
string 
必需
X-User-Token
默认值:
{{X-User-Token}}
Body 参数application/json
name
string 
任务名称
必需
wayline_uuid
string 
航线文件UUID
必需
sn
string 
机场SN
必需
landing_dock_sn
string 
必需
降落机场SN,非蛙跳任务可不填
rth_altitude
integer 
返航高度
必需
rth_mode
enum<string> 
返航模式
必需
枚举值:
optimalpreset
wayline_precision_type
enum<string> 
任务精度
必需
枚举值:
gpsrtk
out_of_control_action_in_flight
enum<string> 
必需
丢失信号后无人机动作
枚举值:
return_homecontinue_task
resumable_status
enum<string> 
自动断点续飞
必需
枚举值:
automanual
task_type
enum<string> 
任务类型
必需
枚举值:
immediatetimedrecurringcontinuous
time_zone
string 
必需
时区,TZ database中的时区名称
repeat_type
enum<string> 
任务重复模式
必需
枚举值:
nonrepeatingdailyweeklyabsolute_monthlyrelative_monthly
repeat_option
必需
Any of
interval
integer 
必需
重复间隔时间: 最小1,每几天
>= 1
begin_at
integer  | null 
必需
开始时间,秒级时间戳,立即任务不需要填,对于定时任务这个值代表任务执行时间。对于重复任务和连续任务这个值代表任务的开始时间。
end_at
integer  | null 
必需
结束时间,秒级时间戳,重复/连续任务必须填写
recurring_task_start_time_list
array[integer]
必需
重复任务的多个开始执行的时间,秒级时间戳,必须跟“begin_at”时间同一天。
continuous_task_periods
array [array] 
必需
连续任务的多个执行时间段,秒级时间戳,必须跟“begin_at”时间同一天。
integer 
秒级时间戳
可选
min_battery_capacity
integer 
必需
连续执行最低执行电量
>= 50<= 100
示例
{
    "name": "flight_task_01",
    "sn": "8PHDM8D0010097",
    "time_zone": "Asia/Chongqing",
    "wayline_uuid": "80232917-2f63-4375-8614-0c70c4458aa3",
    "rth_altitude": 110, 
    "rth_mode": "optimal", 
    "wayline_precision_type": "rtk", 
    "out_of_control_action_in_flight": "return_home", 
    "resumable_status": "manual",
    "task_type": "immediate"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://es-flight-api-cn.djigate.com/openapi/v0.1/flight-task' \
--header 'X-Request-Id;' \
--header 'X-Language: zh' \
--header 'X-Project-Uuid: {{X-Project-Uuid}}' \
--header 'Content-Type: application/json' \
--header 'X-User-Token;' \
--data-raw '{
    "name": "flight_task_01",
    "sn": "8PHDM8D0010097",
    "time_zone": "Asia/Chongqing",
    "wayline_uuid": "80232917-2f63-4375-8614-0c70c4458aa3",
    "rth_altitude": 110, 
    "rth_mode": "optimal", 
    "wayline_precision_type": "rtk", 
    "out_of_control_action_in_flight": "return_home", 
    "resumable_status": "manual",
    "task_type": "immediate"
}'

返回响应

🟢200成功
application/json
Body
code
integer 
非0代表异常
必需
message
string 
消息提示
必需
data
object 
必需
task_uuid
string 
必需
示例
{
    "code": 0,
    "message": "success",
    "data": {
        "task_uuid": "1280bab3-3b0d-4517-a53c-3257e48319e5"
    }
}
上一页
任务管理教程
下一页
更新飞行任务状态
Built with