Make Device Enter Relay Pairing Mode

POST

/openapi/v2.0/device/relay_model

Basic logic of relay pairing: relay device and operating controller. When pairing, be sure to mark the relay device and operating aircraft clearly. Do not randomly attempt pairing operations. If triggered by mistake, you can recover by rebooting devices and re-pairing

Request

Header Params

Body Params application/json

Example

{
    "device_sn": "1581F8HHD24CQ0010211",
    "pair_enable": true,
    "pair_type": "drone"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/v2.0/device/relay_model' \
--header 'X-Request-Id: {{$string.uuid}}' \
--header 'X-Request-Id: {{$string.uuid}}' \
--header 'X-Language: zh' \
--header 'X-Language: zh' \
--header 'X-Project-Uuid: 9ea47c41-cf9b-4f27-87d8-e1646cb5e67a' \
--header 'X-User-Token: {{X-User-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "device_sn": "1581F8HHD24CQ0010211",
    "pair_enable": true,
    "pair_type": "drone"
}'

Responses

🟢200

application/json

Bodyapplication/json

Example

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

🟠400

🟠401

🟠403

🔴500

Modified at 2026-05-26 14:41:41

Query Relay Pairing Result

Get HMS Information