Acquire Control Permission

POST

/openapi/v2.0/device/control

If you need to operate on the payload of a specific aircraft, you must first acquire the control permission for that payload device, then operate on it - for example, switching the lens of an aircraft's payload camera.

The payload_index parameter can be obtained from data.list.drone.camera_list.camera_index in the device list.

Request

Header Params

Body Params application/json

Example

{
    "drone_sn": "1581F6QAD238F0010244",
    "flight": true,
    "payload_index": [
        "81-0-0"
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/v2.0/device/control' \
--header 'X-Request-Id: {{$string.uuid}}' \
--header 'X-Request-Id: {{$string.uuid}}' \
--header 'X-Language: zh' \
--header 'X-Language: zh' \
--header 'X-Project-Uuid: be1e0ee4-2a3e-4150-82ca-ec1d2626efa3' \
--header 'X-User-Token: {{X-User-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "drone_sn": "1581F6QAD238F0010244",
    "flight": true,
    "payload_index": [
        "81-0-0"
    ]
}'

Responses

🟢200

application/json

Bodyapplication/json

Example

{
    "code": 0,
    "message": "",
    "data": {
        "drone_sn": "1581F6QAD238F0010244",
        "controls": [
            {
                "type": "flight",
                "gateway": {
                    "sn": "7CTDL9K00A0035"
                },
                "user": {
                    "call_sign": "bobby.yang",
                    "user_id": "1998235816238661632",
                    "type": "cloud"
                }
            },
            {
                "type": "payload",
                "payload_index": "81-0-0",
                "gateway": {
                    "sn": ""
                },
                "user": {
                    "call_sign": "bobby.yang",
                    "user_id": "1998235816238661632",
                    "type": "cloud"
                }
            }
        ]
    }
}

🟠400

🟠401

🟠403

🔴500

Modified at 2026-05-26 14:32:15

Get HMS Information

Release Control Permission