Aircraft Lens Switch

POST

/openapi/v2.0/device/change-lens

Supports switching the aircraft camera lens between wide-angle, zoom, and infrared.

You must first call the Acquire Control Permission interface to obtain aircraft control permission before switching the aircraft lens.

camera_index and lens_type can be obtained from data.list.drone:.camera_list in the Get Device List Under Organization interface.

Request

Header Params

Body Params application/jsonRequired

Example

{
    "sn": "7CTDL9K00A0009",
    "camera_index": "165-0-7",
    "lens_type": "wide"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/v2.0/device/change-lens' \
--header 'X-User-Token: {{X-User-Token}}' \
--header 'X-Project-Uuid: be1e0ee4-2a3e-4150-82ca-ec1d2626efa3' \
--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 '{
    "sn": "7CTDL9K00A0009",
    "camera_index": "165-0-7",
    "lens_type": "wide"
}'

Responses

🟢200Success

application/json

Bodyapplication/json

Example

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

🟠400

🔴500

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

Get Cloud Control Status

Dock Camera Switch