[任务管理]创建接力任务

POST

/openapi/v0.9/task/api/v1/workspaces/{proj_uuid}/flight-tasks/relay-missions

es-task-service

创建一个新的接力飞行任务

请求参数

Path 参数

proj_uuid

string

必需

Header 参数

x-user-token

string

必需

默认值:

X-Request-Id

string

可选

默认值:

{% mock 'uuid' %}

Body 参数application/json

flight_id

string

必需

飞行任务ID
required: true

示例值:

flight_123

main_drone_sn

string

必需

主设备序列号
required: true

示例值:

SN123456

mission_position

object

必需

任务位置信息
required: true

height

number

可选

latitude

number

可选

longitude

number

可选

observe_target_position

object

观察目标位置

可选

height

number

可选

latitude

number

可选

longitude

number

可选

prj_uuid

string

必需

项目UUID
required: true

示例值:

4dbc6ef2-0e3c-4d47-8b32-552a44f573c5

relay_mission_configs

object

必需

接力任务配置
required: true

commander_flight_height

number

指点飞行高度（米）

可选

>= 20<= 1500

示例值:

100

commander_flight_mode

integer

指点飞行模式

可选

示例值:

early_departure_time

integer

必需

提前起飞时间（秒）
required: true

>= 60<= 1500

示例值:

120

end_at

integer

必需

任务结束时间（Unix时间戳）
required: true

>= 0<= 9999999999

示例值:

1742449728

main_rth_altitude

integer

必需

主设备返航高度（米）
required: true

>= 15<= 1500

示例值:

100

max_speed

integer

最大速度（米/秒）

可选

示例值:

out_of_control_action

enum<string>

必需

失控动作：Hover-悬停，ReturnHome-返航，Continue-继续执行
required: true

枚举值:

HoverReturnHomeContinue

示例值:

ReturnHome

secondary_rth_altitude

integer

必需

从设备返航高度（米）
required: true

>= 15<= 1500

示例值:

100

security_takeoff_height

number

安全起飞高度（米）

可选

示例值:

time_zone

string

时区

可选

示例值:

Asia/Shanghai

secondary_drone_sn

string

必需

从设备序列号
required: true

示例值:

["SN789012"]

示例

{
    "flight_id": "flight_123",
    "main_drone_sn": "SN123456",
    "mission_position": {
        "height": 0,
        "latitude": 0,
        "longitude": 0
    },
    "observe_target_position": {
        "height": 0,
        "latitude": 0,
        "longitude": 0
    },
    "prj_uuid": "4dbc6ef2-0e3c-4d47-8b32-552a44f573c5",
    "relay_mission_configs": {
        "commander_flight_height": 100,
        "commander_flight_mode": 1,
        "early_departure_time": 120,
        "end_at": 1742449728,
        "main_rth_altitude": 100,
        "max_speed": 10,
        "out_of_control_action": "Hover",
        "secondary_rth_altitude": 100,
        "security_takeoff_height": 20,
        "time_zone": "Asia/Shanghai"
    },
    "secondary_drone_sn": [
        "SN789012"
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/openapi/v0.9/task/api/v1/workspaces//flight-tasks/relay-missions' \
--header 'x-user-token;' \
--header 'X-Request-Id: {% mock '\''uuid'\'' %}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "flight_id": "flight_123",
    "main_drone_sn": "SN123456",
    "mission_position": {
        "height": 0,
        "latitude": 0,
        "longitude": 0
    },
    "observe_target_position": {
        "height": 0,
        "latitude": 0,
        "longitude": 0
    },
    "prj_uuid": "4dbc6ef2-0e3c-4d47-8b32-552a44f573c5",
    "relay_mission_configs": {
        "commander_flight_height": 100,
        "commander_flight_mode": 1,
        "early_departure_time": 120,
        "end_at": 1742449728,
        "main_rth_altitude": 100,
        "max_speed": 10,
        "out_of_control_action": "Hover",
        "secondary_rth_altitude": 100,
        "security_takeoff_height": 20,
        "time_zone": "Asia/Shanghai"
    },
    "secondary_drone_sn": [
        "SN789012"
    ]
}'

返回响应

🟢200成功

application/json

成功响应

Body

object | null

HTTP响应模板

可选

code

integer

响应码

可选

message

string

响应消息

可选

data

object | null

响应数据

可选

示例

{
    "code": 0,
    "message": "string",
    "data": {}
}

修改于 2025-05-13 13:27:23

接力任务

[任务管理]编辑接力任务