创建飞行任务

开发中

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>

请求唯一标识

必需

默认值:

X-Language

enum<string>

可选

枚举值:

zhen

默认值:

X-Project-Uuid

string

项目编号

可选

默认值:

X-User-Token

string

必需

X-User-Token

默认值:

Body 参数application/json

name

string

任务名称

必需

wayline_uuid

string

航线文件UUID

必需

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

task_repeat_option_daily

task_repeat_option_weekly

task_repeat_option_absolute_monthly

task_repeat_option_relative_monthly

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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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"
  }
}

修改于 2025-02-18 09:19:11

任务管理教程

更新飞行任务状态