使用限制

最近更新时间:2019-08-02 15:58:04

接口调用频率限制

群组系统

接口 后台调用限制 特别说明
创建群组 单 App 限制100次/秒 单个 App 每天净增群组限制10000 个,如果超出该限制,请 提交工单 开通;单个 App 最多可拥有1亿个群组,但当总群组数量超过10万时,需要付费使用,详细价格说明请参见 价格说明 文档
添加群组成员 单 App 限制100次/秒 一次最多支持添加100个成员,单个用户最大可加入1000个群组,具体请参见 产品价格 文档
删除群组成员 单 App 限制100次/秒 一次请求最多可删除500个成员
修改群成员资料 单 App 限制100次/秒 -
获取用户加入的群组 单 App 限制100次/秒 如果用户加入的群组超过5000个,该用户只能拉取到最先加入的5000个群组
查询用户在群组中的身份 单 App 限制100次/秒 一次请求最多支持查询500个帐号
批量禁言 单 App 限制100次/秒 一次请求最多可禁言500个帐号
批量取消禁言 单 App 限制100次/秒 一次请求最多可取消500个帐号的禁言
发送普通消息 单 App 限制100次/秒 单个群的默认发送频率限制为40条/秒,单条消息长度限制为9000字节。特别说明:如果5分钟内同一发送者的两条消息的随机值(Random 参数)相同,后面那条消息将被当做重复消息而丢弃
发送系统通知 单 App 限制100次/秒 -
导入群消息 单 App 限制100次/秒 单次最多可导入20条消息,要求按消息时间戳递增的顺序导入,消息时间戳必须大于建群时间且小于当前时间,否则失败
导入群成员 单 App 限制100次/秒 音视频聊天室和在线成员广播大群不支持导入群成员,一次请求最多支持导入500个成员
拉取群漫游消息 单 App 限制100次/秒 音视频聊天室和在线成员广播大群不支持漫游消息;其它类型群组默认支持七天的漫游消息
查询 App 中的所有群组 单 App 限制100次/秒 -
获取群组消息资料 单 App 限制100次/秒 -
获取群成员详细资料 单 App 限制100次/秒 -
修改群组基础资料 单 App 限制100次/秒 -
解散群组 单 App 限制100次/秒 -
获取群组被禁言用户列表 单 App 限制100次/秒 -
转让群组 单 App 限制100次/秒 -
导入群基础资料 单 App 限制100次/秒 -
设置群成员未读消息计数 单 App 限制100次/秒 -
删除指定用户发送的消息 单 App 限制100次/秒 -
设置全局禁言 单 App 限制100次/秒 -
查询全局禁言 单 App 限制100次/秒 -
查询 App 自定义脏字 单 App 限制100次/秒 -
添加 App 自定义脏字 单 App 限制100次/秒 自定义脏字总数最多不超过5000个
删除 App 自定义脏字 单 App 限制100次/秒 -

资料系统

接口 后台调用限制 特别说明
设置资料 单 App 限制100次/秒 资料支持标配字段及自定义字段,其中自定义字段的关键字,必须是英文字母,且长度不得超过8字节,自定义字段的值最长不能超过500字节
拉取资料 单 App 限制100次/秒 -

关系链系统

接口 后台调用限制 特别说明
拉取最近联系人 - 当前普通用户最多保存100个最近联系人
添加好友 单 App 限制100次/秒 当前单个用户支持3000个好友,添加好友时未决消息最多支持100条;好友分组最多支持32个,每个分组的名称最长30字节;好友备注最长支持96字节
添加黑名单 单 App 限制100次/秒 当前单个用户最多允许的黑名单人数为1000人
导入好友 单 App 限制100次/秒 如果使用批量导入好友,最多只能导入1000个好友
删除好友 单 App 限制100次/秒 -
删除所有好友 单 App 限制100次/秒 -
校验好友 单 App 限制100次/秒 -
拉取好友 单 App 限制100次/秒 -
删除黑名单 单 App 限制100次/秒 -
拉取黑名单 单 App 限制100次/秒 -
校验黑名单 单 App 限制100次/秒 -

单聊消息系统

接口 后台调用限制 特别说明
单聊消息单发 单 App 限制100次/秒 这里建议同一对帐号发消息,频率不要超过10条/秒,超过在线可收到,但离线只保存10条/秒,超过的会丢弃;单条消息长度不能超过9000字节
单聊消息群发 单 App 限制100 次/秒 一次性针对最多500个用户进行单发消息。单条消息长度不能超过9000字节
单聊消息导入 单 App 限制100次/秒 -

帐号系统

接口 后台调用限制 特别说明
获取用户在线状态 单 App 限制100次/秒 一次请求最多可以查询500个用户的状态
UserSig 失效接口 单 App 限制1000次/秒 -
单个帐号导入 单 App 限制1000次/秒 用户名长度不超过32字节
批量帐号导入 单 App 限制10次/秒 单个用户名长度不超过32字节,单次最多导入100个用户名

其它

接口 后台调用限制 特别说明
REST API 单 App 限制100次/秒 当前所有后台 REST API 限制都为100次/秒,如果想提高频率,请 提交工单 修改

业务特性限制

功能特性 限制类型 限制说明
消息内容 内容长度 单聊、群聊消息,单条消息最大长度限制为9000字节,超过此长度会被系统丢弃
发送文件 文件大小 当前文件消息中,SDK 端的单个文件大小限制为28M,WEBSDK 端的单个文件大小限制为20M,请不要超过此限制
系统消息 数量及存储时间 最多保存100条,存储时长不超过7天
多终端在线 在线模式 目前支持设置四种多段登录形式:单端登录(仅允许 Windows、Web、Android 或 iOS 单端登录)、双端登录(允许 Windows、Android 或 iOS 单端登录,同时允许与 Web 端同时在线)、三端登录(允许 Android 或 iOS 单端登录,同时允许与 Windows 和 Web 端同时在线)、多端同时在线(允许 Windows、Web、Android 或 iOS 多端或全端同时在线登录)。您可以在即时通信 IM 控制台 进行修改
Identifier 命名限制 用户帐号,Identifier 长度建议不超过32字节
UserSig 有效期 用户密码,即时通信 IM 后台 SDK 默认接口生成的签名有效期为180天
单聊/群聊消息 消息漫游时长 目前单聊消息及群聊消息,含私有群(Private)、公开群(Public)和聊天室(ChatRoom),具备消息漫游能力(默认7天)。如需保存更长时间,您可以在即时通信 IM 控制台 修改消息漫游时长。延长消息漫游时长是增值服务,具体计费说明请参见 价格说明
群组资料 资料内容限制 群名称最长30字节,群简介最长240字节,群公告最长300字节,群头像 URL 最长100字节,群名片最大不超过50个字节
群组成员 成员数量 最大群成员数量:私有群是200人,公开群是2000人,聊天室是10000人,音视频聊天室和在线成员广播大群无限制
自定义群组 ID ID 命名限制 自定义群组 ID 必须为可打印 ASCII 字符(0x20-0x7e),最长48个字节,且前缀不能为 @TGS#(避免与默认分配的群组 ID 混淆)
群组维度自定义字段 字段限制 群组维度最多支持20个自定义字段,字段 Key 为 String 类型,长度不超过16字节,其命名仅支持英文大小写字母、数字、下划线;字段 Value 为用户自定义 Buffer,可以为二进制数据,群维度的 Value 长度不超过512字节
群成员维度自定义字段 字段限制 群成员维度最多支持5个自定义字段,字段 Key 为 String 类型,长度不超过16字节,其命名仅支持英文大小写字母、数字、下划线;字段 Value 为用户自定义 Buffer,可以为二进制数据,群成员维度的 Value 长度不超过64字节