logo
On this page

SetWhiteboardRoomAuth

GET

https://whiteboard-api.zego.im/

Call this API to set the default whiteboard permissions for a room.

  • After successful configuration, users in this room will use the whiteboard with these room permissions by default.
  • If user permissions are set separately, those users will use the whiteboard according to their user-level permissions.
  • When a room is destroyed, its permissions are also cleared. After destruction, if users log into a room with the same RoomId and want to use room permissions, they need to set the room permissions again.

Set the room default permissions to:

  • Whiteboard can be zoomed and scrolled.
  • Can create graphic elements and modify others' graphic elements.
    Note
    Rate limit: 50 requests/second (Test environment: 1 request/second).

Request

Query Parameters

    Action stringrequired

    Possible values: [SetWhiteboardRoomAuth]

    API endpoint parameter

    https://whiteboard-api.zego.im/?Action=SetWhiteboardRoomAuth

    AppId uint32required

    💡Public parameter. Application ID, assigned by ZEGOCLOUD. Get it from the ZEGOCLOUD Admin Console.

    SignatureNonce stringrequired

    💡Public parameter. A 16-character hexadecimal random string (hex encoding of 8-byte random number). Refer to Signature sample code for how to generate.

    Timestamp int64required

    💡Public parameter. Current Unix timestamp, in seconds. Refer to Signature sample code for how to generate, with a maximum error of 10 minutes.

    SignatureVersion stringrequired

    Possible values: [2.0]

    Default value: 2.0

    💡Public parameter. Signature version number.

    Signature stringrequired

    💡Public parameter. Signature, used to verify the legitimacy of the request. Refer to Signing the requests for how to generate.

    RoomId stringrequired

    The room ID to set permissions for.

    ModuleAuth number[]required

    Possible values: [0, 1, 2]

    Whiteboard operation permission set. Empty arrays are not allowed.

    • 0: No permission
    • 1: Allow zooming the whiteboard
    • 2: Allow scrolling the whiteboard

    Example: ModuleAuth[]=1&ModuleAuth[]=2

    GraphicAuth number[]required

    Possible values: [0, 2, 4, 8, 16, 32]

    Graphic element operation permission set. Empty arrays are not allowed.

    • 0: No operation permission
    • 2: Allow modifying graphic elements created by others
    • 4: Allow erasing graphic elements created by others
    • 8: Allow moving graphic elements created by others
    • 16: Allow clearing graphic elements
    • 32: Allow creating graphic elements

    Example: GraphicAuth[]=32&GraphicAuth[]=2

Responses​

OK
Schema
    Code number

    Return code.

    Only business-related return codes are listed below. For common return codes, please refer to Common error codes.

    Return codeDescription
    120000001Signature authentication failed.
    120000002Invalid input parameters.
    120000103Failed to set room permissions.
    120000105Failed because an empty array was passed for the permission set.
    120000106Invalid permission value set in the permission collection.
    120000301Room does not exist.
    Message string

    Details.

    RequestId string

    Unique request ID generated by ZEGOCLOUD.

Previous

Call API online

Next

Set user permissions

On this page

Back to top