Device Management/Device Configuration/Pairing Management
Device Management

Make Device Enter Relay Pairing Mode

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

post/openapi/v2.0/device/relay_model

Request

  • Base URL
    (relative, and it does not resolve against the document’s source URL)
  • URL
    /openapi/v2.0/device/relay_model
  • Auth
    none required

Headers

X-Request-Idstring uuid

Request Unique Identifier

X-Language'zh' | 'en'

Language

X-Project-Uuidstring required

Project Number

X-User-Tokenstring required

Request body

device_snstring required

Relay device SN (NOT the operating aircraft SN). Relay pairing is anchored on the relay device

pair_enableboolean required

true = enter relay pairing mode; false = exit relay pairing mode. On exit, pair_type must still be correctly provided to clean up the corresponding side's binding

pair_type'drone' | 'relay' required

Which side of the device this pairing operation targets: drone = operating-aircraft side (pair/unpair between the relay and an already-paired operating aircraft); relay = relay-device side (the relay's own pairing switch, e.g., putting the relay into pending-pair state first, then letting the operating aircraft scan to bind). If triggered by mistake, recover by rebooting the device and re-pairing

Example request

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

Response

codestring required

Non-zero Indicates Exception

messagestring required

Message Prompt

dataunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.