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

PUT

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

es-task-service

编辑现有的接力飞行任务配置

请求参数

Path 参数

proj_uuid

string

必需

relay_mission_id

string

接力任务ID

必需

示例值:

"123"

Header 参数

x-user-token

string

必需

默认值:

X-Request-Id

string

可选

默认值:

{% mock 'uuid' %}

Body 参数application/json

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

relay_mission_id

integer

必需

接力任务ID
required: true

示例值:

123

示例

{
    "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"
    },
    "relay_mission_id": 123
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT '/openapi/v0.9/task/api/v1/workspaces//flight-tasks/relay-missions/"123"' \
--header 'x-user-token;' \
--header 'X-Request-Id: {% mock '\''uuid'\'' %}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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"
    },
    "relay_mission_id": 123
}'

返回响应

🟢200成功

application/json

成功响应

Body

object | null

HTTP响应模板

可选

code

integer

响应码

可选

message

string

响应消息

可选

data

object | null

响应数据

可选

示例

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

修改于 2025-07-01 03:44:55

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

[任务管理]主动起飞