https://xxxxxx/v4/room_engine_http_srv/create_room?sdkappid=88888888&identifier=admin&usersig=xxx&random=99999999&contenttype=json
Parameter | Description |
xxxxxx | The reserved domain name for the country/region where the SDKAppID is located: Singapore : adminapisgp.im.qcloud.com |
v4/room_engine_http_srv/create_room | Request API |
sdkappid | The SDKAppID assigned by the Chat console when an app is created |
identifier | |
usersig | The Signature generated by the App administrator account. For more details, please refer to Generating UserSig. |
random | Enter a random 32-bit unsigned integer ranging from 0 to 4294967295 |
contenttype | The request format fixed value is json |
{"RoomInfo":{"RoomId": "room-test","RoomName": "room-name-test","RoomType": "Conference","Owner_Account": "user2","MaxMemberCount": 300,"ScheduleStartTime" : 1693271355,"ScheduleEndTime" : 1693272355,"IsVideoDisabled": true,"IsAudioDisabled": true,"IsMessageDisabled": true,"IsScreenSharingDisabled": true,"IsCloudRecordingDisabled": true,"CustomInfo": "custom123","IsSeatEnabled": true,"MaxSeatCount": 16,"TakeSeatMode": "ApplyToTake"},"ScheduleInviteeList_Account":["user1", "user2", "user3"]}
Field | Type | Attribute | Description |
RoomId | String | Mandatory | Room ID, up to 48 bytes |
RoomName | String | Optional | Room Name, defaults to Room ID, up to 100 bytes |
RoomType | String | Mandatory | Room Type: Conference (Meeting Room) |
Owner_Account | String | Optional | |
MaxMemberCount | Integer | Optional | Maximum number of room members, default value when not specified: Upper limit of paid package, for example, the trial version is 20, if upgrading the package, this field must be updated according to modify room information. |
ScheduleStartTime | Integer | Optional | Scheduled meeting start time, the default is current time. |
ScheduleEndTime | Integer | Optional | Scheduled meeting end time, default is 1 hour after the start time, the minimum meeting time cannot be less than 5 minutes, and the maximum time cannot exceed 24h. |
IsVideoDisabled | Bool | Optional | Mute all video, default false |
IsAudioDisabled | Bool | Optional | Mute all audio, default false |
IsMessageDisabled | Bool | Optional | Disable all members from sending text messages, default false |
IsScreenSharingDisabled | Bool | Optional | Disable screen sharing, default false |
IsCloudRecordingDisabled | Bool | Optional | Disable cloud recording, default false |
CustomInfo | String | Optional | Custom Information, maximum 500 bytes |
IsSeatEnabled | Bool | Optional | Whether to support seat position. Not supported by default. |
MaxSeatCount | Integer | Optional | Maximum number of seats, default is the package limit (max 20 by default). |
TakeSeatMode | String | Optional | Seat mode: FreeToTake (open mic), ApplyToTake (mic on request) |
ScheduleInviteeList_Account | Array | Optional | Scheduled member list, up to 300 members |
{"ActionStatus": "OK","ErrorInfo": "","ErrorCode": 0,"RequestId": "Id-8c9858f01e954611ae2d4c1b1ed7d583-O-Seq-52720"}
Field | Type | Description |
ActionStatus | String | The result of the request process. OK for success; FAIL for failure. |
ErrorCode | Integer | Error code. 0 for success, others for failure. |
ErrorInfo | String | Error message |
RequestId | String | The unique request ID is returned for each request and required to provide this RequestId when locating issues. |
Error Code | Description |
100001 | Internal server error, please retry. |
100002 | Invalid parameter, please check the request for correctness based on the error description. |
100003 | The room ID already exists, please choose another room ID. |
100007 | No payment information, you need to purchase a package in the console. |
100010 | The room ID has been used, and the operator is the home owner, you can use it directly. |
100011 | The room ID has been used by Chat, you can change to another room ID or destroy the group through the Chat interface. |
100012 | The frequency limit for creating a room has been exceeded. The same room ID can only be created once per second. |
Was this page helpful?