Real-time Control/Control Permission Management/Cloud Control Permission
Real-time Control/Control Management/Cloud Control Permission
Real-time Control/Control Authority Management/Cloud Control Permission (V0.9 Compatibility)

Acquire (Occupy) Cloud Control Permission

Current user directly occupies cloud control authority for specified aircraft (at control_keys granularity; can simultaneously occupy flight + multiple payload_{index}); no remote controller approval required. After successful occupation, all related users immediately receive WebSocket real-time change notification (reason=Acquire). Difference from "Apply for Cloud Control Authorization" (POST /cloud_control_auth): this API directly forces occupation; the latter uses remote-controller request-approve flow.

post/openapi/v2.0/drc/api/v1/projects/{uuid}/cloud_controls

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/drc/api/v1/projects/{uuid}/cloud_controls
  • 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

drone_snstring required

Target Aircraft SN

control_keysstring[] required

Control Key List to Occupy, at least 1 item; each item is flight or payload_{payload_index}

gateway_snstring nullable

Specified Gateway SN (e.g. Dock SN). If omitted, server selects based on current aircraft topology

Response

Operation Successful

codeinteger required

Business Status Code: 0=Success; non-zero=Error Code (see message for meaning)

messagestring

Error Description Message (Omitted on Success)

Changes

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