[任务管理]更新接力任务状态

PUT

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

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

mission_position

object

可选

任务位置信息（状态为running时必填）
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_id

integer

必需

接力任务ID
required: true

示例值:

123

return_home_drone_sn

string

返航设备序列号

可选

示例值:

SN123456

status

enum<string>

必需

任务状态：paused-暂停，running-运行，cancel-取消
required: true

枚举值:

pausedrunningcancel

示例值:

running

示例

{
    "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_id": 123,
    "return_home_drone_sn": "SN123456",
    "status": "paused"
}

示例代码

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"/status' \
--header 'x-user-token;' \
--header 'X-Request-Id: {% mock '\''uuid'\'' %}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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_id": 123,
    "return_home_drone_sn": "SN123456",
    "status": "paused"
}'

返回响应

🟢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

[任务管理]主动起飞

[任务管理]切换接力任务