Send Real-time Control Command

POST

/openapi/v2.0/device/{device_sn}/command

During wayline flight or manual flight, you can call this command for real-time control of the aircraft, such as return-to-home, cancel return-to-home, flight task pause and resume operations

Request

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "device_command": "return_home"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/v2.0/device/1581FBJ4D261U0010385/command' \
--header 'X-User-Token: {{X-User-Token}}' \
--header 'X-Project-Uuid: 61f8983b-03be-482d-b046-6ec1019c3364' \
--header 'X-Request-Id: {{$string.uuid}}' \
--header 'X-Request-Id: {{$string.uuid}}' \
--header 'X-Language: zh' \
--header 'X-Language: zh' \
--header 'Content-Type: application/json' \
--data '{
    "device_command": "return_home"
}'

Responses

🟢200

application/json

Operation Successful

Bodyapplication/json

Example

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

🟠401

🟠403

🟠404

🔴500

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

Query Device Command Execution

Query Takeoff/Landing Coordination Area (TCA) Real-time Status