配额限制

本页介绍灵动课堂的配额限制。

API 限速

灵动课堂服务端 API 的调用频率参见下表：

限制范围	URI 规则	频次限制	说明
声网账号（非每个 App ID）	/{region}/edu/apps/{appId}/...	1000 次/秒	灵动课堂单区域内所有服务端 API 共享调用频次限制（不同区域 QPS 限制互相独立）。
单个房间	/{region}/edu/apps/{appId}/... /rooms/{roomUuid}/...	100 次/秒	灵动课堂房间相关的接口，单区域相同的 appId + roomUuid 共享调用频次限制。房间相关接口包括但不限于： 创建课堂 查询课堂 设置课堂状态 更新课堂自定义属性 删除课堂自定义属性 删除课堂自定义属性 开启/关闭分组讨论 设置录制状态 更新录制设置 查询录制列表 删除 Widget 房间属性 删除 Widget 查询指定类型事件 查询指定 Widget 事件 查询答题器事件 查询投票器事件
单个房间内单个用户	/{region}/edu/apps/{appId}/... /rooms/ /{roomUuid}/users/{userUuid}/...	60 次/分	灵动课堂房间用户相关的接口，单区域相同的 appId + roomUuid + userUuid 共享调用频次限制。房间用户相关接口包括但不限于： 查询指定用户 更新用户自定义属性 删除用户自定义属性 踢人 设置 Widget 用户属性 删除 Widget用户属性

当一个服务端 API 调用超出频率限制时，会返回状态码 429，表示请求过于频繁。你可以结合业务实际并发需求，参考以下建议，优化 API 调用频率：

• 将 API 请求均匀地分布到各时间窗口。例如，要调用 /{region}/edu/apps/{appId}/v2/rooms/{roomUuid} 创建 1000 个房间时，为避免请求超出全局调用上限，你可以每秒创建 200 个房间，分 5 秒创建完成。
• 不要在你的客户端直接调用声网的服务端 API，而要在你的应用服务器上调用声网的服务端 RESTful API。例如，在使用设置房间属性接口时，不要在每个学生端同时设置房间属性，可以由学生端请求你的应用服务器，由你的应用服务器定期汇总房间属性后，再调用设置房间属性 API 进行设置。

同时在线人数 PCU

灵动课堂支持最大同时在线人数为 10,000 人。

提升配额

如果你想提升配额，可以联系技术支持。