使用限制
更新时间:2022-04-27
本文简要介绍环信即时通讯 IM 的使用限制条件,包括调用频率、字符串大小和编码格式等。
用户注册
- username
用户 ID:长度不可超过 64 个字节长度。不可设置为空。支持以下字符集:• 26 个小写英文字母 a-z; • 26 个大写英文字母 A-Z;• 10 个数字 0-9; • “_”, “-”, “.”。 注意: • 该参数不区分大小写,因此 Aa
和 aa
为相同用户名; • 请确保同一个 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。