IM 即时通讯
服务端
更新日志
服务端集成新手指南
接口及业务限制
平台服务
第三方回调
第三方回调概述
消息相关回调
用户信息相关回调
高级群相关回调
超大群相关回调
聊天室相关回调
音视频1.0相关回调
IM 登录相关回调
圈组相关回调
消息抄送
消息抄送服务概述
开通消息抄送
IM会话相关抄送
IM 会话已读数据抄送
IM其他抄送
圈组相关抄送
音视频和白板相关抄送
安全通
安全通概述
开通 IM 安全通
最佳实践
聊天室重要消息投递
IM 平滑迁移方案
API 参考
API调用方式
API 概览与频控
状态码/错误码
云信 IM 账号管理
注册云信IM账号
刷新Token
封禁账号
账号全局禁言
账号功能模块禁言
设置移动端是否需要推送(桌面端在线时)
登录鉴权
消息功能
发送消息
批量发送单聊消息
发送单聊已读回执
发送群聊已读回执
消息撤回
发送广播消息
文件上传
删除单条消息
删除漫游消息
历史消息与记录
云端历史消息查询
广播消息查询
IM 登录/登出记录查询
自定义系统通知
发送自定义系统通知
批量发送自定义系统通知
用户名片
用户关系管理
好友关系管理
黑名单/静音管理
群组
高级群
创建高级群
拉人入群
发送群消息
添加管理员
移除管理员
转让群主
禁言群组
禁言指定群成员
踢人出群
主动退群
修改群昵称
修改群组信息
设置群消息提醒开关
解散群组
获取群组详细信息
获取群组禁言列表
获取群消息已读未读详情
获取用户已加入的群组信息
获取用户已加入的群组的所有群成员信息
获取群组的在线成员列表
批量获取群组信息与成员列表
批量获取群组的在线成员数量
超大群
创建超大群
拉人入群
发送超大群消息
发送超大群自定义系统通知
撤回超大群消息
添加管理员
移除管理员
转让群主
禁言超大群
禁言指定超大群成员
踢人出群
主动退群
修改超大群昵称
修改超大群信息
修改超大群成员信息
解散超大群
修改超大群人数级别
获取超大群信息
获取超大群成员信息
获取超大群禁言成员信息
获取已加入的超大群信息
查询超大群云端历史消息
聊天室
创建聊天室
获取聊天室地址
更新聊天室信息
查询聊天室信息
开放/关闭聊天室
查询开放状态的聊天室
设置聊天室定时关闭
开启/关闭进出聊天室事件通知
管理聊天室用户角色
获取聊天室成员列表
聊天室消息管理
发送聊天室消息
批量发送聊天室消息
撤回聊天室消息
发送聊天室定向消息
批量发送聊天室定向消息
发送聊天室全服广播消息
管理聊天室机器人
聊天室禁言
聊天室标签
管理聊天室队列
管理聊天室队列元素
圈组
圈组 API 概览
获取圈组连接地址
服务器相关
创建服务器
修改服务器信息
删除服务器
批量查询服务器信息
分页查询服务器列表
服务器成员相关
邀请服务器成员
接受邀请
拒绝邀请
申请加入服务器
接受申请
拒绝申请
生成邀请码
通过邀请码加入
踢出成员
主动退出服务器
修改自己的成员信息
修改他人的成员信息
分页查询服务器成员列表
批量查询服务器成员信息
查询服务器的申请和邀请记录
查询个人的申请和邀请记录
更新成员封禁状态
分页查询封禁成员列表
频道相关
创建频道
修改频道基础信息
修改频道分组相关信息
删除频道
分页查询频道列表
批量查询频道信息
分页查询频道成员列表
修改频道黑白名单成员
修改频道黑白名单身份组
分页查询频道黑白名单成员列表
分页查询频道黑白名单身份组列表
批量查询频道黑白名单成员
批量查询频道黑白名单身份组
频道分组相关
创建频道分组
修改频道分组信息
删除频道分组
批量查询频道分组信息
分页查询频道分组列表
分页查询频道分组下的频道列表
修改频道分组黑白名单身份组
修改频道分组黑白名单成员
分页查询频道分组的黑白名单身份组列表
分页查询频道分组的黑白名单成员列表
批量查询频道分组的黑白名单身份组
批量查询频道分组的黑白名单成员
身份组相关
服务器身份组
身份组成员管理
频道身份组
频道用户定制权限
频道分组身份组
频道分组用户定制权限
身份组自定义权限项
查询用户拥有的权限
圈组消息相关
发送消息
更新消息
查询云端历史消息
查询 Thread 聊天历史
批量查询Thread聊天meta 信息
更新快捷评论
查询快捷评论
查询@某人的未读消息
系统通知相关
圈组系统通知概述
发送自定义系统通知
更新自定义系统通知
搜索结果自定义排序
修改服务器自定义排序值
修改频道自定义排序值
在线状态订阅
文本翻译
推送payload配置

接口及业务限制

更新时间: 2023/03/21 16:21:37

消息功能

功能 限制说明
消息内容 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流控/频控默认值