下发设备排障命令

POST

/openapi/v0.9/manage/api/v1/organizations/{org_uuid}/manage-devices/cmds

es-management-service

向指定设备下发排障命令

请求参数

Path 参数

org_uuid

string

必需

Header 参数

x-user-token

string

必需

默认值:

X-Request-Id

string

可选

默认值:

{% mock 'uuid' %}

Body 参数application/json

device_cmd_data

object | null

指令参数

可选

当method=rtk_calibration需传入此参数

devices

array [object {4}] | null

可选

device_cmd_method

string

必需

设备指令方法
required: true
example: debug_mode_close关闭远程调试
更多method枚举参考https://developer.dji.com/doc/cloud-api-tutorial/cn/api-reference/dock-to-cloud/mqtt/dock/dock3/cmd.html 中的method值

device_sn

string

必需

设备序列号
required: true
example: ABCD1234567890

示例

{
    "device_cmd_data": {
        "devices": [
            {
                "sn": "string",
                "type": 0,
                "module": "string",
                "data": {
                    "height": 0,
                    "latitude": 0,
                    "longitude": 0
                }
            }
        ]
    },
    "device_cmd_method": "string",
    "device_sn": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/openapi/v0.9/manage/api/v1/organizations//manage-devices/cmds' \
--header 'x-user-token;' \
--header 'X-Request-Id: {% mock '\''uuid'\'' %}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "device_cmd_data": {
        "devices": [
            {
                "sn": "string",
                "type": 0,
                "module": "string",
                "data": {
                    "height": 0,
                    "latitude": 0,
                    "longitude": 0
                }
            }
        ]
    },
    "device_cmd_method": "string",
    "device_sn": "string"
}'

返回响应

🟢200成功

application/json

成功响应

Body

HTTP响应模板

code

integer

响应码

可选

message

string

响应消息

可选

data

object

响应数据

可选

bid

string

可选

业务ID
required: false
example: bid-123456

data

object | null

可选

此字段待废弃，不建议使用

output

object | null

可选

此字段根据不同的method指令返回不同，请参考https://developer.dji.com/doc/cloud-api-tutorial/cn/api-reference/dock-to-cloud/mqtt/dock/dock3/cmd.html 对应命令的output

status

string

可选

命令状态
description: 待废弃字段

tid

string

可选

任务ID
example: tid-123456

timestamp

integer

可选

时间戳
example: 1609459200
description: Unix时间戳(秒)

示例

{
    "code": 0,
    "message": "OK",
    "data": {
        "bid": "f5aab057-xxxx-8dc9af194d96",
        "tid": "",
        "timestamp": 0,
        "status": "ok",
        "job_document": null,
        "data": null,
        "output": {
            "status": "ok"
        }
    }
}

修改于 2025-06-27 12:01:55