Real-time Control/Control Permission Management/Device Control Permission

Acquire (Occupy) Cloud Control Role

Current user requests and occupies a cloud control role (e.g. flight_control / payload_control) for specified dock / aircraft. After successful occupation, the role becomes held by "Cloud Control"; all related users immediately receive WebSocket real-time change notification.

This API is the 0.9 compatibility version. New business is recommended to use POST /openapi/v2.0/drc/api/v1/projects/{uuid}/cloud_controls. Corresponding release API: DELETE /openapi/v2.0/manage/api/v1/projects/{uuid}/drc/roles.

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

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}/drc/roles
  • 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 Device SN (usually Dock SN)

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)

dataunknown

Changes

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