使用限制

更新时间:2022-04-27

本文简要介绍环信即时通讯 IM 的使用限制条件,包括调用频率、字符串大小和编码格式等。

- username 用户 ID:长度不可超过 64 个字节长度。不可设置为空。支持以下字符集:
• 26 个小写英文字母 a-z;
• 26 个大写英文字母 A-Z;
• 10 个数字 0-9;
• “_”, “-”, “.”。
注意:
• 该参数不区分大小写,因此 Aaaa 为相同用户名;
• 请确保同一个 app 下,username 唯一;
username 用户 ID 是会公开的信息,请勿使用 UUID、邮箱地址、手机号等敏感信息。

- 批量注册每次最多 60 个用户 ID。

根据不同的套餐版本,用户好友数有如下限制:

套餐版本好友人数上限
免费版 100
专业版 3,000
旗舰版 无上限
尊享版 无上限

根据不同的套餐版本,消息存储时长有如下限制:

套餐版本 消息存储时长
免费版 3 天
专业版 7 天
旗舰版 90 天
尊享版 180 天

根据不同的套餐版本,群组有如下限制:

套餐版本 群组总数 群成员数 用户可加入群组数
免费版 100 100 100
专业版 100,000 300 600
旗舰版 无上限 3,000 无上限
尊享版 无上限 8,000 无上限

群组名称,用户自定义,字符串类型,最大长度为 128 字符。 群组描述,用户自定义,字符串类型,最大长度为 512 字符。 群组扩展信息,例如可以给群组添加业务相关的标记,最大长度为 1,024 字符。

根据不同的套餐版本,聊天室有如下限制:

套餐版本 聊天室总数 聊天室成员数 用户可加入聊天室数
免费版
专业版 100 无上限 无上限
旗舰版 无上限 无上限 无上限
尊享版 无上限 无上限 无上限

聊天室名称,用户自定义,字符串类型,最大长度为 128 字符。 聊天室描述,用户自定义,字符串类型,最大长度为 512 字符。

每秒频道发消息数量不能超过 100。

新版调用频率限制见:https://docs-im.easemob.com/ccim/limitationapi

根据不同的套餐版本,客户端和 REST API 调用频率有如下限制:

套餐版本 单 IP 调用频率
免费版 10 次/秒
专业版 30 次/秒
旗舰版 50 次/秒
尊享版 200 次/秒

客户端和 REST API 调用频率详细说明:

接口类型 描述 限流说明
用户相关 单个或批量注册、获取和删除用户;重置用户密码;修改用户信息;查看用户在线状态。 单 IP 调用限制
好友关系 单个或批量添加好友;解除好友关系;查看好友信息。 单 IP 调用限制
黑名单 单个或批量添加/移除黑名单;获取指定用户黑名单。 单 IP 调用限制
用户账号封禁 对指定用户账号进行封禁/解禁;强制用户下线。 单 IP 调用限制
离线消息 查询离线消息数和指定离线消息状态。 单 IP 调用限制
下载聊天记录 下载历史消息文件。 单 app 调用限 1 次/分钟
上传和下载 上传/下载图片、语音、文件;下载缩略图。 单 IP 调用限制
群组相关 分页获取群组列表;创建、修改、删除群组;获取群组详情和成员;单个/批量添加或移除群组成员;群主转让;单个/批量添加或移除黑名单。 单 IP 调用限制
聊天室相关 创建、修改、删除聊天室;获取聊天室详情和在线用户列表;单个/批量加入或退出聊天室。 单 IP 调用限制

对于不同的消息类型,消息长度限制如下:

消息类型 消息长度限制 相关 API
文本消息 5 KB createTxtSendMessage
图片消息 10 MB createImageSendMessage
语音消息 10 MB createVoiceSendMessage
视频消息 10 MB createVideoSendMessage
文件消息 10 MB createFileSendMessage
透传消息 5 KB createSendMessage
消息自定义扩展 扩展消息大小不能超过原类型消息的大小 createSendMessage
自定义消息 5 KB createSendMessage

默认单一用户的属性总长不得超过 2 KB,默认一个 app 下所有用户的属性总长度不得超过 10 GB。