使用限制

业务特性限制

功能特性
限制项
限制说明
单聊/群聊消息
内容长度
单聊、群聊消息,单条消息最大长度限制为12K
发送频率
单聊消息发送频率:端上发出时无限制;REST API 发出时相应接口有频率限制,可查看相应接口的文档。群聊消息发送频率:每个群限40条/秒(针对所有群类型,且不同群内发消息,限频互不影响)
接收频率
Android/iOS/Mac/Windows/iPad:单聊和群聊均无限制Web:低于2.11.2的 SDK 版本,不超过1000条/秒(单聊和群聊的总和);2.11.2版本以上的无限制
单个文件大小
发送文件消息时,SDK 最大支持发送单个文件大小为100MB
SDK 不支持创建和发送文件消息
WebIM SDK 不支持创建和发送语音消息
历史消息存储时长
单聊消息及非直播群消息具备历史消息存储能力,不同默认配置如下:
开发版:7天,不支持延长
标准版:7天,支持延长
进阶版:30天,支持延长
UserID
命名规则
用户帐号长度不超过32字节,不支持使用特殊字符,建议使用英文字母或数字
用户资料
自定义字段
自定义字段的关键字必须是英文字母且长度不得超过8字节,自定义字段的值最长不能超过500字节
UserSig
有效期
用户密码,即时通信 IM 后台 SDK 默认接口生成的签名有效期为180天
会话管理
最近联系人数量
每个用户默认保存100个最近联系人,进阶版最多支持500个最近联系人,可在控制台自助配置
用户关系链
好友及分组
单个用户支持3000个好友
添加好友时未读消息最多支持100条
好友分组最多支持32个
每个分组的名称最长30字节
好友备注最长支持96字节
WebIM SDK 从2.13.0起支持好友关系链
黑名单
单个用户最多允许的黑名单人数为1000人
群组
群组数量
指单个 SDKAppID 中同时存在的所有群组类型群数之和,已解散的群组不计数,若已达峰值,可先解散无需使用的群组再创建新群组。不同限制如下:
开发版: 100个
标准版或进阶版:无上限
群成员数量
直播群(AvChatRoom):无成员数量上限
非直播群,不同默认配置如下:
开发版:20人/群
标准版 :200人/群,支持拓展至2000人/群
进阶版:2000人/群,支持拓展至6000人/群
用户可加入群组数
指用户同时加入的所有群组类型群数之和,不同限制如下:
开发版:50个群/人
标准版:500个群/人,支持扩展至1000个群/人
进阶版:支持扩展至3000个群/人
群资料
群名称最长30字节
群简介最长240字节
群公告最长300字节
群头像 URL 最长100字节
群名片最大不超过50个字节
自定义群组 ID
自定义群组 ID 必须为可打印 ASCII 字符(0x20-0x7e),最长48个字节,且前缀不能为 @TGS#(避免与默认分配的群组 ID 混淆)
群组维度自定义字段
群组维度最多支持10个自定义字段:
字段 Key 为 String 类型,长度不超过16字节,其命名仅支持英文大小写字母、数字、下划线
字段 Value 为用户自定义 Buffer,可以为二进制数据,群维度的 Value 长度不超过512字节
群成员维度自定义字段
群成员维度最多支持5个自定义字段:
字段 Key 为 String 类型,长度不超过16字节,其命名仅支持英文大小写字母、数字、下划线
字段 Value 为用户自定义 Buffer,可以为二进制数据,群成员维度的 Value 长度不超过64字节
社群中话题数量
一个社群目前最大支持200个话题


接口相关限制

说明
本文仅列出涉及使用限制的 REST API,更全面的 API 列表请参见 REST API 接口列表

通用限制

限制项
限制说明
调用频率
最高200次/秒:其余 REST API


帐号管理

接口
限制说明
导入多个帐号
单次最多导入100个用户名,且本接口不支持直接导入帐号的昵称和头像信息
查询帐号在线状态
一次请求最多可以查询500个用户的状态


单聊消息

接口
限制说明
批量发单聊消息
一次请求最多可给500个用户发送单聊消息


关系链管理

接口
限制说明
导入好友
一次请求最多只能导入1000个好友


群组管理

接口
限制说明
增加群组成员
一次最多支持添加100个成员
删除群组成员
一次请求最多可删除500个成员
查询用户在群组中的身份
一次请求最多支持查询500个帐号
批量禁言和取消禁言
一次请求最多可禁言/取消禁言500个帐号
在群组中发送普通消息
单个群的默认发送频率限制为40条/秒如果5分钟内同一发送者的两条消息的随机值(Random 参数)相同,后面的消息将被当做重复消息而丢弃
导入群消息
一次请求最多可导入20条消息,要求按消息时间戳递增的顺序导入,消息时间戳必须大于建群时间且小于当前时间,否则失败
导入群成员
直播群(AvChatRoom)不支持导入群成员一次请求最多可导入300个成员,但群成员数上限同时受不同群组类型的特性约束,详情请参见 群组功能