Real-time Control/Payload Control/Camera Control

Dispatch Payload Control Command

Dispatch control commands to specified aircraft's payload (gimbal / camera / speaker, and other airborne payloads) in project, e.g. gimbal pitch / photo / video / lens switch / zoom, etc. Caller must hold the aircraft's payload control authority to execute commands.

post/openapi/v2.0/manage/api/v1/projects/{uuid}/payload-commands

Request

  • Base URL
    https://41b04hdzmc.apifox.cn (the document declares no server; this is the origin it was published from)
  • URL
    https://41b04hdzmc.apifox.cn/openapi/v2.0/manage/api/v1/projects/{uuid}/payload-commands
  • Auth
    none required

Path parameters

uuidstring required

Project UUID

Headers

x-user-tokenstring required

User Login Session Token (client invocation credential for on-premises deployment)

X-Request-Idstring uuid

Client-Generated Request Trace ID (UUID v4 recommended), used for cross-service log correlation and troubleshooting

X-Project-Uuidstring required

Project UUID

Request body

device_snstring required

Target Aircraft SN

device_cmd_methodstring required

Payload command method name. The server validates the method against a supported command whitelist; methods not in the whitelist will be rejected. Common values: camera_photo_take (Take Photo), camera_recording_start (Start Recording), camera_recording_stop (Stop Recording), gimbal_reset (Gimbal Reset), camera_focal_length_set (Focal Length Setting), camera_aim (Camera Aim Target), camera_screen_split (Screen Split Switch), etc.

need_user_verifyboolean

Whether to Require User Identity Re-Verification (sensitive operation scenarios), default false

uuidstring uuid

Request Idempotency Key (UUID v4 Format)

Response

Operation Successful

dataunknown

Changes

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