This page provides detailed help for the Flexible Classroom RESTful APIs.
All requests are sent to the host: api.agora.io.
The Content-Type of all requests is application/json.
Flexible Classroom Cloud Service uses tokens for authentication. You need to put the following information to the x-agora-token
and x-agora-uid
fields when sending your HTTP request:
For details, see Generate an RTM Token.
Call this method to kick a specified user out of a classroom. After a successful method call, the server triggers an event indicating a user leaves the classroom. You can use the dirty
parameter to determine whether the user can enter the classroom afterwards.
URL parameters
Pass the following parameters in the URL.
Parameter | Type | Description |
---|---|---|
region |
String | (Required) The region for connection. For details, see Network geofencing. Flexible Classroom supports the following regions:cn : Mainland China.ap : Asia Pacific.eu : Europe.na : North America. |
appId |
String | (Required) Agora App ID. |
roomUuid |
String | (Required) The classroom ID. This is the globally unique identifier of a classroom. It is also used as the channel name when a user joins an RTC or RTM channel. The string length must be less than 64 bytes. Supported character scopes are: |
userUuid |
String | (Required) The user ID. This is the unique identifier of the user and also the user ID used when logging in to the Agora RTM system. The string length must be less than 64 bytes. Supported character scopes are: |
Request body parameters
Pass in the following parameters in the request body.
Parameter | Type | Description |
---|---|---|
dirty |
Object | (Optional) The user privilege:
|
Request URL
https://api.agora.io/edu/apps/{your_app_Id}/v2/rooms/test_class/users/123/exit
Request Body
{
"dirty": {
"state": 1,
"duration": 600
}
}
Parameter | Type | Description |
---|---|---|
code |
Integer | Business status code: |
msg |
String | The detailed information. |
ts |
Number | The current Unix timestamp (in milliseconds) of the server in UTC. |
{
"msg": "Success",
"code": 0,
"ts": 1610167740309
}
Call this method to set the classroom state: Not started, Started, Ended. For details, see What classroom states does Flexible Classroom support?
URL parameters
Pass the following parameter in the URL.
Parameter | Type | Description |
---|---|---|
region |
String | (Required) The region for connection. For details, see Network geofencing. Flexible Classroom supports the following regions:cn : Mainland China.ap : Asia Pacific.eu : Europe.na : North America. |
appId |
String | (Required) Agora App ID. |
roomUuid |
String | (Required) The classroom ID. This is the globally unique identifier of a classroom. It is also used as the channel name when a user joins an RTC or RTM channel. The string length must be less than 64 bytes. Supported character scopes are: |
state |
Integer | (Required) The classroom state:0 : Not started.1 : Started.2 : Ended.3 : The room is closed and users can no longer join the room. |
https://api.agora.io/edu/apps/{yourappId}/v2/rooms/test_class/states/1
Parameter | Type | Description |
---|---|---|
code |
Integer | Business status code: |
msg |
String | The detailed information. |
ts |
Number | The current Unix timestamp (in milliseconds) of the server in UTC. |
"status": 200,
"body":
{
"code": 0,
"msg": "Success",
"ts": 1610450153520
}
Call this method to start or stop recording a specified classroom.
URL parameters
Pass the following parameter in the URL.
Parameter | Type | Description |
---|---|---|
region |
String | (Required) The region for connection. For details, see Network geofencing. Flexible Classroom supports the following regions:cn : Mainland China.ap : Asia Pacific.eu : Europe.na : North America. |
appId |
String | (Required) Agora App ID. |
roomUuid |
String | (Required) The classroom ID. This is the globally unique identifier of a classroom. It is also used as the channel name when a user joins an RTC or RTM channel. The string length must be less than 64 bytes. Supported character scopes are: |
state |
Integer | (Required) The recording state:0 : Stop recoding.1 : Started. |
Request body parameters
Pass in the following parameters in the request body.
Parameter | Type | Description |
---|---|---|
mode |
String | (Optional) The recording mode:web to enable web page recording mode. The format of recorded files is MP4. When the length of the recorded file reaches around two hours, or when the size of the file exceeds around 2 GB, the recording service automatically creates another MP4 file. |
webRecordConfig |
Object | (Optional) When the mode is set as web , you need to set the detailed configuration of the web page recording through webRecordConfig , including the following fields:
|
retryTimeout |
Number | The amount of time (seconds) that the Flexible Classroom cloud service waits between tries. The Flexible Classroom cloud service reties twice at most. |
Request URL
https://api.agora.io/edu/apps/{yourappId}/v2/rooms/test_class/records/states/1
Request Body
{
"mode": "web",
"webRecordConfig": {
"url":"https://webdemo.agora.io/xxxxx/?userUuid={recorder_id}&roomUuid={room_id_to_be_recorded}&roleType=0&roomType=4&pretest=false&rtmToken={recorder_token}&language=en&appId={your_app_id}",
"rootUrl":"https://xxx.yyy.zzz"
},
"retryTimeout": 60
}
Parameter | Type | Description |
---|---|---|
code |
Integer | Business status code: |
msg |
String | The detailed information. |
ts |
Number | The current Unix timestamp (in milliseconds) of the server in UTC. |
"status": 200,
"body":
{
"code": 0,
"ts": 1610450153520
}
Call this method during the recording to update the recording configurations. Every time this method is called, the previous configurations are overwritten.
URL parameters
Pass the following parameter in the URL.
Parameter | Type | Description |
---|---|---|
region |
String | (Required) The region for connection. For details, see Network geofencing. Flexible Classroom supports the following regions:cn : Mainland China.ap : Asia Pacific.eu : Europe.na : North America. |
appId |
String | (Required) Agora App ID. |
roomUuid |
String | (Required) The classroom ID. This is the globally unique identifier of a classroom. It is also used as the channel name when a user joins an RTC or RTM channel. The string length must be less than 64 bytes. Supported character scopes are: |
Request body parameters
Pass in the following parameters in the request body.
Parameter | Type | Description |
---|---|---|
webRecordConfig |
Object | (Optional) Recording configurations:
|
Request URL
https://api.agora.io/edu/apps/{yourappId}/v2/rooms/test_class/records/states/1
Request Body
{
"webRecordConfig": {
"onhold": false
}
}
Parameter | Type | Description |
---|---|---|
code |
Integer | Business status code: |
msg |
String | The detailed information. |
ts |
Number | The current Unix timestamp (in milliseconds) of the server in UTC. |
"status": 200,
"body":
{
"code": 0,
"ts": 1610450153520
}
Get the recording list in a specified classroom.
You can fetch data in batches with the nextId
parameter. You can get up to 100 pieces of data for each batch.
URL parameters
Pass the following parameter in the URL.
Parameter | Type | Description |
---|---|---|
region |
String | (Required) The region for connection. For details, see Network geofencing. Flexible Classroom supports the following regions:cn : Mainland China.ap : Asia Pacific.eu : Europe.na : North America. |
appId |
String | (Required) Agora App ID. |
roomUuid |
String | (Required) The classroom ID. This is the globally unique identifier of a classroom. It is also used as the channel name when a user joins an RTC or RTM channel. The string length must be less than 64 bytes. Supported character scopes are: |
Query parameters
Parameter | Type | Description |
---|---|---|
nextId |
String | (Optional) The starting ID of the next batch of data. When you call this method to get the data for the first time, leave this parameter empty or set it as null. Afterward, you can set this parameter as the nextId that you get in the response of the previous method call. |
Example one:
https://api.agora.io/edu/apps/{yourappId}/v2/rooms/test_class/records?null
Example two:
https://api.agora.io/edu/apps/{yourappId}/v2/rooms/test_class/records?nextId=xxx
Parameter | Type | Description |
---|---|---|
code |
Integer | Business status code: |
msg |
String | The detailed information. |
ts |
Number | The current Unix timestamp (in milliseconds) of the server in UTC. |
data |
Object | Include the following parameters:
|
"status": 200,
"body":
{
"code": 0,
"msg": "Success",
"ts": 1610450153520,
"data": {
"total": 17,
"list": [
{
"recordId": "xxxxxx",
"appId": "xxxxxx",
"roomUuid": "jason0",
"startTime": 1602648426497,
"endTime": 1602648430262,
"resourceId": "xxxxxx",
"sid": "xxxxxx",
"recordUid": "xxxxxx",
"boardId": "xxxxxx",
"boardToken": "xxxxxx",
"type": 2,
"status": 2,
"url": "scenario/recording/xxxxxx/xxxxxx/xxxxxx.m3u8",
"recordDetails":[
{
"url":"xxxx/xxxx.mp4"
}
]
},
{...},
],
"count": 17
}
}
Call this method to upload a public resource to the specified classroom. All users in the classroom can see these public resources.
URL parameters
Pass the following parameters in the URL.
Parameter | Type | Description |
---|---|---|
region |
String | (Required) The region for connection. For details, see Network geofencing. Flexible Classroom supports the following regions:cn : Mainland China.ap : Asia Pacific.eu : Europe.na : North America. |
appId |
String | (Required) Agora App ID. |
roomUuid |
String | (Required) The classroom ID. This is the globally unique identifier of a classroom. It is also used as the channel name when a user joins an RTC or RTM channel. The string length must be less than 64 bytes. Supported character scopes are: |
resourceUuid |
String | (Required) The resource ID. This is the unique identifier of a file. The string length must be less than 64 bytes. Supported character scopes are: |
Request body parameters
Pass in the following parameters in the request body.
Parameter | Type | Description |
---|---|---|
resourceName |
String | The resource name for display in the classroom. The string length must be less than 64 bytes. |
size |
Number | (Required) The size (bytes) of the resource. |
ext |
String | (Required) The resource extension:
|
url |
String | (Required) The URL address of the resource, such as "https://xxx.com" . |
conversion |
Object | (Optional) If you want to display resources such as a PPT on the whiteboard in the classroom, you need to set conversion to convert the resource into a static image or a dynamic HTML page. conversion contains the following fields:
|
Request URL
https://api.agora.io/edu/apps/{your_app_Id}/v1/rooms/test_class/resources/class_file_1
Request Body
{
"resourceName": "class_file",
"size": 1024,
"ext":"ppt",
"url":"https://xxx.com",
"conversion": {
"type":"static",
"preview": false,
"scale": 1.2,
"outputFormat": ""
},
}
Parameter | Type | Description |
---|---|---|
code |
Integer | Business status code: |
msg |
String | The detailed information. |
ts |
Number | The current Unix timestamp (in milliseconds) of the server in UTC. |
data |
Object Array | An array of republic resources. Each object represents a public resource and contains the following fields:
|
{
"msg":"Success",
"code":0,
"ts":1610433913533,
"data":{
"resourceUuid": "class_file_1",
"resourceName": "class_file",
"ext": "ppt",
"size": 1024,
"url": "https://xxx.com",
"updateTime": 0,
"convert": true,
"taskUuid":"",
"taskToken":"",
"taskProgress": {
"totalPageSize": 10,
"convertedPageSize": 3,
"convertedPercentage": 30,
"convertedFileList": [{
"name": 1,
"ppt":{
"width": 1024,
"height": 960,
"src": "xxxx://xxxx.xxx.xx/xxxx.xxx",
"preview": "xxxx://xxxx.xxx.xx/xxxx.xxx",
}
},{...}],
"currentStep": "Extracting"
}
}
}
Delete one or multiple public resources in the specified classroom.
URL parameters
Pass the following parameters in the URL.
Parameter | Type | Description |
---|---|---|
region |
String | (Required) The region for connection. For details, see Network geofencing. Flexible Classroom supports the following regions:cn : Mainland China.ap : Asia Pacific.eu : Europe.na : North America. |
appId |
String | (Required) Agora App ID. |
roomUuid |
String | (Required) The classroom ID. This is the globally unique identifier of a classroom. It is also used as the channel name when a user joins an RTC or RTM channel. The string length must be less than 64 bytes. Supported character scopes are: |
Request body parameters
Pass in the following parameters in the request body.
Parameter | Type | Description |
---|---|---|
resourceUuids |
String array | (Required) An array of resource IDs. The resource ID is the unique identifier of a resource. The string length must be less than 64 bytes. Supported character scopes are: |
Request URL
https://api.agora.io/edu/apps/{your_app_Id}/v1/rooms/test_class/resources
Request Body
{
"resourceUuids": ["uuid1","uuid2"]
}
Parameter | Type | Description |
---|---|---|
code |
Integer | Business status code: |
msg |
String | The detailed information. |
ts |
Number | The current Unix timestamp (in milliseconds) of the server in UTC. |
{
"msg":"Success",
"code":0,
"ts":1610433913533
}
Get all public resources in the specified classroom.
URL parameters
Pass the following parameters in the URL.
Parameter | Type | Description |
---|---|---|
region |
String | (Required) The region for connection. For details, see Network geofencing. Flexible Classroom supports the following regions:cn : Mainland China.ap : Asia Pacific.eu : Europe.na : North America. |
appId |
String | (Required) Agora App ID. |
roomUuid |
String | (Required) The classroom ID. This is the globally unique identifier of a classroom. It is also used as the channel name when a user joins an RTC or RTM channel. The string length must be less than 64 bytes. Supported character scopes are: |
Request URL
https://api.agora.io/edu/apps/{your_app_Id}/v1/rooms/test_class/resources
Parameter | Type | Description |
---|---|---|
code |
Integer | Business status code: |
msg |
String | The detailed information. |
ts |
Number | The current Unix timestamp (in milliseconds) of the server in UTC. |
data |
Object Array | An array of republic resources. Each object represents a public resource and contains the following fields:
|
{
"msg":"Success",
"code":0,
"ts":1610433913533,
"data":[{
"resourceUuid": "",
"resourceName": "",
"ext": "",
"size": 0,
"url": "",
"updateTime": 0,
"convert": true,
"taskUuid":"",
"taskToken":"",
"taskProgress": {
"totalPageSize": 10,
"convertedPageSize": 3,
"convertedPercentage": 30,
"convertedFileList": [{
"name": 1,
"ppt":{
"width": 1024,
"height": 960,
"src": "xxxx://xxxx.xxx.xx/xxxx.xxx",
"preview": "xxxx://xxxx.xxx.xx/xxxx.xxx",
}
},{...}],
"currentStep": "Extracting"
}
}]
}
Query a specified type of event in a specified classroom.
You can fetch data in batches with the nextId
parameter. You can get up to 100 pieces of data for each batch.
URL parameters
Pass the following parameters in the URL.
Parameter | Type | Description |
---|---|---|
region |
String | (Required) The region for connection. For details, see Network geofencing. Flexible Classroom supports the following regions:cn : Mainland China.ap : Asia Pacific.eu : Europe.na : North America. |
appId |
String | (Required) Agora App ID. |
roomUuid |
String | (Required) The classroom ID. This is the globally unique identifier of a classroom. It is also used as the channel name when a user joins an RTC or RTM channel. The string length must be less than 64 bytes. Supported character scopes are: |
Query parameters
Parameter | Type | Description |
---|---|---|
nextId |
String | (Optional) The starting ID of the next batch of data. When you call this method to get the data for the first time, leave this parameter empty or set it as null. Afterward, you can set this parameter as the nextId that you get in the response of the previous method call. |
cmd |
Integer | (Optional) Event type. For details, see Flexible Classroom Cloud Service Events. |
Request URL
Example one:
https://api.agora.io/edu/apps/{appId}/v2/rooms/test_class/sequences?null&cmd=1
Example two:
https://api.agora.io/edu/apps/{appId}/v2/rooms/test_class/sequences?nextId=50&cmd=1
Parameter | Type | Description |
---|---|---|
code |
Integer | Business status code: |
msg |
String | The detailed information. |
ts |
Number | The current Unix timestamp (in milliseconds) of the server in UTC. |
data |
Object | Include the following parameters:
|
{
"msg":"Success",
"code":0,
"ts":1610433913533,
"data":{
"total":1,
"list":[
{
"roomUuid": "",
"cmd": 20,
"sequence": 1,
"version": 1,
"data":{}
}
],
"nextId": null,
"count":1
}
}
Get all events in the classrooms associated with a specified App ID.
You can call this method at regular intervals to listen for all the events that occur in the flexible classrooms.
URL parameters
Pass the following parameter in the URL.
Parameter | Type | Description |
---|---|---|
region |
String | (Required) The region for connection. For details, see Network geofencing. Flexible Classroom supports the following regions:cn : Mainland China.ap : Asia Pacific.eu : Europe.na : North America. |
appId |
String | (Required) Agora App ID. |
https://api.agora.io/edu/polling/apps/{yourappId}/v2/rooms/sequences
Parameter | Type | Description |
---|---|---|
code |
Integer | Business status code: |
msg |
String | The detailed information. |
ts |
Number | The current Unix timestamp (in milliseconds) of the server in UTC. |
data |
Object | Include the following parameters:roomUuid : String, the classroom ID.cmd : Integer, the event type. For details, see Flexible Classroom Cloud Service Events.sequence : Integer. The event ID. This is the unique identifier of an event, which is automatically generated to ensure the order of events.version : Integer, the service version.data : Object, the detailed data of the event. The data varies depending on the event type. For details, see Flexible Classroom Cloud Service Events. |
"status": 200,
"body":
{
"msg": "Success",
"code": 0,
"ts": 1610167740309,
"data":[
{
"roomUuid": "xxxxxx",
"cmd": 20,
"sequence": 1,
"version": 1,
"data":{}
}
]
}
Add or update the custom properties of a specified classroom. For details, see How can I set user properties and classroom properties?
URL parameters
Pass the following parameters in the URL.
Parameter | Type | Description |
---|---|---|
region |
String | (Required) The region for connection. For details, see Network geofencing. Flexible Classroom supports the following regions:cn : Mainland China.ap : Asia Pacific.eu : Europe.na : North America. |
appId |
String | (Required) Agora App ID. |
roomUuid |
String | (Required) The classroom ID. This is the globally unique identifier of a classroom. It is also used as the channel name when a user joins an RTC or RTM channel. The string length must be less than 64 bytes. Supported character scopes are: |
Request body parameters
Pass in the following parameters in the request body.
Parameter | Type | Description |
---|---|---|
properties |
Object | Classroom properties. |
cause |
Object | The update reason. |
Request Body
{
"properties" :{
"key1":"value1",
"key2":"value2"
},
"cause":{}
}
Parameter | Type | Description |
---|---|---|
code |
Integer | Business status code: |
msg |
String | The detailed information. |
ts |
Number | The current Unix timestamp (in milliseconds) of the server in UTC. |
{
"msg": "Success",
"code": 0,
"ts": 1610167740309
}
Delete the custom properties of a specified classroom. For details, see How can I set user properties and classroom properties?
URL parameters
Pass the following parameters in the URL.
Parameter | Type | Description |
---|---|---|
region |
String | (Required) The region for connection. For details, see Network geofencing. Flexible Classroom supports the following regions:cn : Mainland China.ap : Asia Pacific.eu : Europe.na : North America. |
appId |
String | (Required) Agora App ID. |
roomUuid |
String | (Required) The classroom ID. This is the globally unique identifier of a classroom. It is also used as the channel name when a user joins an RTC or RTM channel. The string length must be less than 64 bytes. Supported character scopes are: |
Request body parameters
Pass in the following parameters in the request body.
Parameter | Type | Description |
---|---|---|
properties |
String array | Classroom properties. |
cause |
Object | Reason for deletion. |
Request Body
{
"properties" :[
"key1",
"key2"
],
"cause":{}
}
Parameter | Type | Description |
---|---|---|
code |
Integer | Business status code: |
msg |
String | The detailed information. |
ts |
Number | The current Unix timestamp (in milliseconds) of the server in UTC. |
{
"msg": "Success",
"code": 0,
"ts": 1610167740309
}
Add or update the custom properties of a specified user. For details, see How can I set user properties and classroom properties?
URL parameters
Pass the following parameters in the URL.
Parameter | Type | Description |
---|---|---|
region |
String | (Required) The region for connection. For details, see Network geofencing. Flexible Classroom supports the following regions:cn : Mainland China.ap : Asia Pacific.eu : Europe.na : North America. |
appId |
String | (Required) Agora App ID. |
roomUuid |
String | (Required) The classroom ID. This is the globally unique identifier of a classroom. It is also used as the channel name when a user joins an RTC or RTM channel. The string length must be less than 64 bytes. Supported character scopes are: |
userUuid |
String | (Required) The user ID. This is the unique identifier of the user and also the user ID used when logging in to the Agora RTM system. The string length must be less than 64 bytes. Supported character scopes are: |
Request body parameters
Pass in the following parameters in the request body.
Parameter | Type | Description |
---|---|---|
properties |
Object | The user properties. |
cause |
Object | The update reason. |
Request Body
{
"properties" :{
"key1":"value1",
"key2":"value2"
},
"cause":{}
}
Parameter | Type | Description |
---|---|---|
code |
Integer | Business status code: |
msg |
String | The detailed information. |
ts |
Number | The current Unix timestamp (in milliseconds) of the server in UTC. |
{
"msg": "Success",
"code": 0,
"ts": 1610167740309
}
Delete the custom properties of a specified user. For details, see How can I set user properties and classroom properties?
URL parameters
Pass the following parameters in the URL.
Parameter | Type | Description |
---|---|---|
region |
String | (Required) The region for connection. For details, see Network geofencing. Flexible Classroom supports the following regions:cn : Mainland China.ap : Asia Pacific.eu : Europe.na : North America. |
appId |
String | (Required) Agora App ID. |
roomUuid |
String | (Required) The classroom ID. This is the globally unique identifier of a classroom. It is also used as the channel name when a user joins an RTC or RTM channel. The string length must be less than 64 bytes. Supported character scopes are: |
userUuid |
String | (Required) The user ID. This is the unique identifier of the user and also the user ID used when logging in to the Agora RTM system. The string length must be less than 64 bytes. Supported character scopes are: |
Request body parameters
Pass in the following parameters in the request body.
Parameter | Type | Description |
---|---|---|
properties |
String array | The user properties. |
cause |
Object | Reason for deletion. |
Request Body
{
"properties" :[
"key1",
"key2"
],
"cause":{}
}
Parameter | Type | Description |
---|---|---|
code |
Integer | Business status code: |
msg |
String | The detailed information. |
ts |
Number | The current Unix timestamp (in milliseconds) of the server in UTC. |
{
"msg": "Success",
"code": 0,
"ts": 1610167740309
}
Add or update the properties of the extApp in a specified classroom.
URL parameters
Pass the following parameters in the URL.
Parameter | Type | Description |
---|---|---|
region |
String | (Required) The region for connection. For details, see Network geofencing. Flexible Classroom supports the following regions:cn : Mainland China.ap : Asia Pacific.eu : Europe.na : North America. |
appId |
String | (Required) Agora App ID. |
roomUuid |
String | (Required) The classroom ID. This is the globally unique identifier of a classroom. It is also used as the channel name when a user joins an RTC or RTM channel. The string length must be less than 64 bytes. Supported character scopes are: |
extAppUuid |
String | (Required) The extApp ID. The string length must be less than 64 bytes. Supported character scopes are: |
Request body parameters
Pass in the following parameters in the request body.
Parameter | Type | Description |
---|---|---|
properties |
Object | The user properties. |
common |
Object | The JSON object contains the following fields:state : Integer, the state of extApp. 0 means disabled, and 1 means enabled. |
cause |
Object | The update reason. |
Request Body
{
"properties" :{},
"common":{
"state":0
},
"cause":{}
}
Parameter | Type | Description |
---|---|---|
code |
Integer | Business status code: |
msg |
String | The detailed information. |
ts |
Number | The current Unix timestamp (in milliseconds) of the server in UTC. |
{
"msg": "Success",
"code": 0,
"ts": 1610167740309
}
Delete the properties of the extApp in a specified classroom.
URL parameters
Pass the following parameters in the URL.
Parameter | Type | Description |
---|---|---|
region |
String | (Required) The region for connection. For details, see Network geofencing. Flexible Classroom supports the following regions:cn : Mainland China.ap : Asia Pacific.eu : Europe.na : North America. |
appId |
String | (Required) Agora App ID. |
roomUuid |
String | (Required) The classroom ID. This is the globally unique identifier of a classroom. It is also used as the channel name when a user joins an RTC or RTM channel. The string length must be less than 64 bytes. Supported character scopes are: |
extAppUuid |
String | (Required) The extApp ID. The string length must be less than 64 bytes. Supported character scopes are: |
Request body parameters
Pass in the following parameters in the request body.
Parameter | Type | Description |
---|---|---|
properties |
String array | The user properties. |
cause |
Object | Reason for deletion. |
Request Body
{
"properties" :[
"key-path1",
"key-path2"
],
"cause":{}
}
Parameter | Type | Description |
---|---|---|
code |
Integer | Business status code: |
msg |
String | The detailed information. |
ts |
Number | The current Unix timestamp (in milliseconds) of the server in UTC. |
{
"msg": "Success",
"code": 0,
"ts": 1610167740309
}
Response status code | Business status code | Description |
---|---|---|
200 | 0 | The request succeeds. |
400 | 400 | The request parameter is incorrect. |
401 | N/A | Possible reasons:x-agora-uid or x-agora-token . |
403 | 30403200 | The classroom is muted globally. Users cannot send chat messages. |
404 | N/A | The server cannot find the requested resource. |
404 | 20404100 | The classroom does not exist. |
404 | 20404200 | The user does not exist. |
409 | 30409410 | The recording has not been started. |
409 | 30409411 | The recording has not been ended. |
409 | 30409100 | The class has been started. |
409 | 30409101 | The class has been ended. |
500 | 500 | The server has an internal error and cannot process the request. |
503 | N/A | Internal server error. The gateway or proxy server does not receive a timely response from the upstream server. |