API 参考
圈组

接口及业务限制

更新时间: 2024/07/17 17:57:35

消息功能

功能 限制说明
消息内容 body 字段最大长度 5000 字符
图片消息 无限制,建议应用根据业务场景进行限制
语音消息 录制时长默认 120 秒(支持自定义配置),文件大小无限制,建议应用根据业务场景进行限制
视频消息 视频时长不限,文件大小无限制,建议应用根据业务场景进行限制
文件消息 SDK 上传大小无限制,服务端上传文件最大 15 M,建议应用根据业务场景进行限制
离线消息 对于点对点聊天:下发 30 天内最近 5000 条离线消息(单个会话最多 100 条)。
对于群聊:下发 30 天内的离线消息(单个对话最多 100 条)。
[注意] 聊天室消息不支持离线消息。
漫游消息 自动漫游 7 天内最近 100 个会话,每个会话最近的 100 条消息
单聊/群聊历史记录获取时长 免费版 7 天;专业版 1 年,最长可扩展至 3 年(增值功能)
聊天室历史记录获取时长 10 天
NOS云存储 免费版 1 TB;专业版 1 TB,最长可扩展至 1000 TB(增值功能)

以上增值功能收费请参见:资费说明

好友关系

功能 限制说明
好友数量 默认可添加 3000 个好友,增值服务支持添加 10000 个好友

用户资料

参数 类型 说明
accid String 用户帐号,最大长度 32 字符,必须保证一个 APP 内唯一
name String 用户昵称,最大长度 64 字符
icon String 用户 icon,最大长度 1024 字符
sign String 用户签名,最大长度 256 字符
email String 用户 email,最大长度 64 字符
birth String 用户生日,最大长度 16 字符
mobile String 用户 mobile,最大长度 32 字符,只支持国内号码
gender int 用户性别,0 表示未知,1 表示男,2 表示女,其它会报参数错误
ex String 用户名片扩展字段,最大长度 1024 字符,用户可自行扩展,建议封装成 JSON 字符串

群组功能

功能 限制说明
群组容量 200 人/群,最大可扩展至 5000 人/群(请联系商务经理或技术支持开通增值功能)
建群数量 高级群 100 群/人(免费版50 群/人),最大可扩展至 5000 群/人(请联系商务经理或技术支持开通增值功能)
加群数量 5000 群/人

以上增值功能收费请参见:资费说明

聊天室功能

功能 限制说明
聊天室容量 无限制
创建聊天室数量 200 聊天室/人,如有扩展需求,请联系商务经理
多端同时进入同一聊天室 默认只允许一端同时进入,用户控制台支持配置

用户控制台配置请登录:https://app.netease.im/

事件订阅(在线状态)

功能 限制说明
订阅上限 订阅指定人员的在线状态事件,每个帐号最大有效订阅帐号不超过 3000 个

服务端API流控/频控默认值

功能 限制说明
聊天室消息流控 一秒内默认可下发20条普通消息+10条高优先级消息
发送普通消息频控 一秒内默认可调用该接口100次
发送自定义系统通知频控 一秒内默认可调用该接口100次
批量发送普通消息频控 一分钟内默认可调用该接口120次
批量发送系统通知频控 一分钟内默认可调用该接口120次
群组管理操作频控 一秒内默认可调用该接口100次
发送广播消息频控 一分钟内默认可调用该接口10次
发送聊天室消息频控 一秒内默认可调用该接口100次
聊天室全服广播频控 一分钟内默认可调用该接口10次
此文档是否对你有帮助?
有帮助
去反馈
  • 消息功能
  • 好友关系
  • 用户资料
  • 群组功能
  • 聊天室功能
  • 事件订阅(在线状态)
  • 服务端API流控/频控默认值