API 参考
圈组

云信 IM API 概览与频控

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

本文主要罗列了云信 IM 的 API 接口列表,以及各个接口的使用限制(频控)。

频控说明

  • 单个应用内的用户在一定时间内调用云信 IM 接口的次数超出限制,云信服务端会返回 416 错误码,并且会有一定的惩罚时间,即超出限制后在一定时间内再调用该接口会被屏蔽,各接口的频控限制以及超出限制后的屏蔽时间请查看以下表格。

  • 若根据业务需要调整部分接口的频控,可在云信控制台自行调整,或通过官网首页右侧的联系方式联系云信商务经理进行调整。

IM 接口频控

云信 IM 账号管理

API 请求 URL 默认频控值
注册云信 IM 账号 https://api.netease.im/nimserver/user/create.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
刷新指定 Token https://api.netease.im/nimserver/user/update.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
刷新不指定 Token https://api.netease.im/nimserver/user/refreshToken.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
封禁账号 https://api.netease.im/nimserver/user/block.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
解禁账号 https://api.netease.im/nimserver/user/unblock.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
账号全局禁言 https://api.netease.im/nimserver/user/mute.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
账号功能模块禁言 https://api.netease.im/nimserver/user/muteModule.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
设置移动端是否需要推送(桌面端在线时) https://api.netease.im/nimserver/user/setDonnop.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。

消息功能

API 请求URL 默认频控值
发送消息 https://api.netease.im/nimserver/msg/sendMsg.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
批量发送单聊消息 https://api.netease.im/nimserver/msg/sendBatchMsg.action 单个应用默认最高调用频率:120 次/分,如超限,将被屏蔽 1 分钟。
发送单聊已读回执 https://api.netease.im/nimserver/msg/markReadMsg.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
发送群聊已读回执 https://api.netease.im/nimserver/msg/markReadTeamMsg.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
双向撤回消息 https://api.netease.im/nimserver/msg/recall.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
单向撤回消息 https://api.netease.im/nimserver/msg/delMsgOneWay.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
发送广播消息 https://api.netease.im/nimserver/msg/broadcastMsg.action 单个应用默认最高调用频率:10 次/分,如超限,将被屏蔽 1 分钟。
删除单条广播消息 https://api.netease.im/nimserver/history/delBroadcastMsgById.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
上传文件(非分片) https://api.netease.im/nimserver/msg/upload.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
分片上传文件 https://api.netease.im/nimserver/msg/fileUpload.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
清理已上传文件 https://api.netease.im/nimserver/job/nos/del.action 单个应用默认最高调用频率:5 次/天,如超限,将被屏蔽 1 天。
删除单条消息 https://api.netease.im/nimserver/msg/delMsg.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
删除漫游消息 https://api.netease.im/nimserver/msg/delRoamSession.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。

历史消息与记录

API 请求URL 默认频控值
单聊云端历史消息查询 https://api.netease.im/nimserver/history/querySessionMsg.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
群聊云端历史消息查询 https://api.netease.im/nimserver/history/queryTeamMsg.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
聊天室云端历史消息查询 https://api.netease.im/nimserver/history/queryChatroomMsg.action 单个应用默认最高调用频率:1200 次/分,如超限,将被屏蔽 1 分钟。
删除聊天室云端历史消息 https://api.netease.im/nimserver/chatroom/deleteHistoryMessage.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
云端会话列表查询 https://api.netease.im/nimserver/history/querySessionList.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
查询单条广播消息 https://api.netease.im/nimserver/history/queryBroadcastMsgById.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
批量查询广播消息 https://api.netease.im/nimserver/history/queryBroadcastMsg.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
IM 登录/登出记录查询 https://api.netease.im/nimserver/history/queryUserEvents.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。

自定义系统通知

API 请求URL 默认频控值
发送自定义系统通知 https://api.netease.im/nimserver/msg/sendAttachMsg.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
批量发送自定义系统通知 https://api.netease.im/nimserver/msg/sendBatchAttachMsg.action 单个应用默认最高调用频率:120 次/分,如超限,将被屏蔽 1 分钟。

用户和好友关系

API 请求URL 默认频控值
获取用户名片 https://api.netease.im/nimserver/user/getUinfos.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
更新用户名片 https://api.netease.im/nimserver/user/updateUinfo.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
添加好友 https://api.netease.im/nimserver/friend/add.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
更新好友相关信息 https://api.netease.im/nimserver/friend/update.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
删除好友关系 https://api.netease.im/nimserver/friend/delete.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
获取好友列表 https://api.netease.im/nimserver/friend/get.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
获取好友关系 https://api.netease.im/nimserver/friend/getByAccid.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
设置黑名单/静音 https://api.netease.im/nimserver/user/setSpecialRelation.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
获取指定用户的黑名单和静音列表 https://api.netease.im/nimserver/user/listBlackAndMuteList.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。

高级群

API 请求URL 默认频控值
创建高级群 https://api.netease.im/nimserver/team/create.action 单个应用中默认 1 秒内所有的高级群操作 API 合计最多可调用 100 次,如超限,将被屏蔽 10 秒。 除发送群消息 API 外,其他所有高级群 API 都属于高级群操作 API。
拉人入群 https://api.netease.im/nimserver/team/add.action
添加管理员 https://api.netease.im/nimserver/team/addManager.action
移除管理员 https://api.netease.im/nimserver/team/removeManager.action
转让群主 https://api.netease.im/nimserver/team/changeOwner.action
禁言群主 https://api.netease.im/nimserver/team/muteTlistAll.action
禁言指定群成员 https://api.netease.im/nimserver/team/muteTlist.action
踢人出群 https://api.netease.im/nimserver/team/kick.action
主动退群 https://api.netease.im/nimserver/team/leave.action
修改群组信息 https://api.netease.im/nimserver/team/update.action
修改群昵称 https://api.netease.im/nimserver/team/updateTeamNick.action
设置群消息提醒开关 https://api.netease.im/nimserver/team/muteTeam.action
解散群组 https://api.netease.im/nimserver/team/remove.action
获取群组详细信息 https://api.netease.im/nimserver/team/queryDetail.action
获取群组禁言列表 https://api.netease.im/nimserver/team/listTeamMute.action
获取群消息已读未读详情 https://api.netease.im/nimserver/team/getMarkReadInfo.action
获取用户已加入的群组信息 https://api.netease.im/nimserver/team/joinTeams.action
获取用户已加入的群组的所有群成员信息 https://api.netease.im/nimserver/team/listMemberInfo.action
获取群组的在线成员列表 https://api.netease.im/nimserver/team/listOnlineUsers.action
批量获取群组信息与成员列表 https://api.netease.im/nimserver/team/query.action
批量获取群组的在线成员数量 https://api.netease.im/nimserver/team/listOnlineUserCount.action
发送群消息 https://api.netease.im/nimserver/msg/sendMsg.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。

超大群

API 请求URL 默认频控值
创建超大群 https://api.netease.im/nimserver/superteam/create.action 单个应用中默认 1 秒内所有的超大群操作 API 合计最多可调用 100 次,如超限,将被屏蔽 10 秒。 超大群消息相关 API 外,其他所有超大群 API 都属于超大群操作 API。
超大群消息相关 API 包括:发送超大群消息,发送超大群自定义系统通知,撤回超大群消息,根据用户 ID/消息 ID 查询超大群历史消息。
拉人入群 https://api.netease.im/nimserver/superteam/invite.action
添加管理员 https://api.netease.im/nimserver/superteam/addManager.action
移除管理员 https://api.netease.im/nimserver/superteam/removeManager.action
转让群主 https://api.netease.im/nimserver/superteam/changeOwner.action
禁言超大群 https://api.netease.im/nimserver/superteam/mute.action
禁言指定超大群成员 https://api.netease.im/nimserver/superteam/muteTlist.action
踢人出群 https://api.netease.im/nimserver/superteam/kick.action
主动退群 https://api.netease.im/nimserver/superteam/leave.action
修改超大群昵称 https://api.netease.im/nimserver/superteam/updateTeamNick.action
修改超大群信息 https://api.netease.im/nimserver/superteam/updateTinfo.action
修改超大群成员信息 https://api.netease.im/nimserver/superteam/updateTlist.action
解散超大群 https://api.netease.im/nimserver/superteam/dismiss.action
修改超大群人数级别 https://api.netease.im/nimserver/superteam/changeLevel.action
获取超大群信息 https://api.netease.im/nimserver/superteam/getTinfos.action
获取超大群成员信息 https://api.netease.im/nimserver/superteam/getTlists.action
获取超大群禁言成员信息 https://api.netease.im/nimserver/superteam/getMuteTlists.action
获取已加入的超大群信息 https://api.netease.im/nimserver/superteam/joinTeams.action
根据用户 ID 查询超大群历史消息 https://api.netease.im/nimserver/superteam/queryHistoryMsg.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
根据消息 ID 查询超大群历史消息 https://api.netease.im/nimserver/superteam/queryHistoryMsgByIds.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
发送超大群消息 https://api.netease.im/nimserver/superteam/sendMsg.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
发送超大群自定义系统通知 https://api.netease.im/nimserver/superteam/sendAttachMsg.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
撤回超大群消息 https://api.netease.im/nimserver/superteam/recallMsg.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。

聊天室

API 请求URL 默认频控值
创建聊天室 https://api.netease.im/nimserver/chatroom/create.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
获取聊天室地址 https://api.netease.im/nimserver/chatroom/requestAddr.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
更新聊天室信息 https://api.netease.im/nimserver/chatroom/update.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
查询聊天室信息 https://api.netease.im/nimserver/chatroom/get.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
批量查询聊天室信息 https://api.netease.im/nimserver/chatroom/getBatch.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
开放/关闭聊天室 https://api.netease.im/nimserver/chatroom/toggleCloseStat.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
查询开放状态的聊天室 https://api.netease.im/nimserver/chatroom/queryUserRoomIds.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
设置聊天室定时关闭 https://api.netease.im/nimserver/chatroom/updateDelayClosePolicy.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
开启/关闭进出聊天室时间通知 https://api.netease.im/nimserver/chatroom/updateInOutNotification.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
聊天室踢人 https://api.netease.im/nimserver/chatroom/kickMember.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
设置聊天室角色 https://api.netease.im/nimserver/chatroom/setMemberRole.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
变更聊天室角色 https://api.netease.im/nimserver/chatroom/updateMyRoomRole.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
分页获取聊天室成员列表 https://api.netease.im/nimserver/chatroom/membersByPage.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
根据角色获取聊天室成员列表 https://api.netease.im/nimserver/chatroom/queryMembersByRole.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
批量获取聊天室成员信息 https://api.netease.im/nimserver/chatroom/queryMembers.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
发送聊天室消息 https://api.netease.im/nimserver/chatroom/sendMsg.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
批量发送聊天室消息 https://api.netease.im/nimserver/chatroom/batchSendMsg.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
撤回聊天室消息 https://api.netease.im/nimserver/chatroom/recall.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
发送聊天室定向消息 https://api.netease.im/nimserver/chatroom/sendMsgToSomeone.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
批量发送聊天室定向消息 https://api.netease.im/nimserver/chatroom/batchSendMsgToSomeone.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
发送聊天室全服广播消息 https://api.netease.im/nimserver/chatroom/broadcast.action 单个应用默认最高调用频率:10 次/分,如超限,将被屏蔽 1 分钟。
添加聊天室机器人 https://api.netease.im/nimserver/chatroom/addRobot.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
删除聊天室机器人 https://api.netease.im/nimserver/chatroom/removeRobot.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
清空聊天室机器人 https://api.netease.im/nimserver/chatroom/cleanRobot.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
设置临时禁言状态 https://api.netease.im/nimserver/chatroom/temporaryMute.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
聊天室整体禁言 https://api.netease.im/nimserver/chatroom/muteRoom.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
标签禁言 https://api.netease.im/nimserver/chatroom/tagTemporaryMute.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
查询标签下的在线用户数 https://api.netease.im/nimserver/chatroom/tagMembersCount.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
根据标签查询在线成员列表 https://api.netease.im/nimserver/chatroom/tagMembersQuery.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
根据标签查询历史消息 https://api.netease.im/nimserver/chatroom/queryTagHistoryMsg.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
修改聊天室用户标签 https://api.netease.im/nimserver/chatroom/updateChatRoomRoleTag.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
初始化队列 https://api.netease.im/nimserver/chatroom/queueInit.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
删除清理队列 https://api.netease.im/nimserver/chatroom/queueDrop.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
添加或更新元素 https://api.netease.im/nimserver/chatroom/queueOffer.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
批量添加队列元素 https://api.netease.im/nimserver/chatroom/queueBatchOffer.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
批量更新队列元素 https://api.netease.im/nimserver/chatroom/queueBatchUpdateElements.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
排序列出队列中所有元素 https://api.netease.im/nimserver/chatroom/queueList.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
从队列中取出元素 https://api.netease.im/nimserver/chatroom/queuePoll.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
获取指定的队列元素 https://api.netease.im/nimserver/chatroom/queueMultiGet.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。

在线状态订阅

API 请求URL 默认频控值
订阅在线状态事件 https://api.netease.im/nimserver/event/subscribe/add.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
查询在线状态事件订阅关系 https://api.netease.im/nimserver/event/subscribe/query.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
取消在线状态事件订阅 https://api.netease.im/nimserver/event/subscribe/delete.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
取消全部在线状态事件订阅 https://api.netease.im/nimserver/event/subscribe/batchdel.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。

其他

API 请求URL 默认频控值
文本翻译 https://api.netease.im/nimserver/translator/textMsg.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。

圈组

圈组相关 API 请参考圈组 API 概览

调整接口频控

对于部分接口支持在云信控制台自行调整,其他接口频控的变更需要联系云信商务经理处理。

支持在云信控制台自行调整的接口:

API 请求 URL 默认频控值
发送普通消息 https://api.netease.im/nimserver/msg/sendMsg.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
批量发送普通消息 https://api.netease.im/nimserver/msg/sendBatchMsg.action 单个应用默认最高调用频率:120 次/分,如超限,将被屏蔽 1 分钟。
发送自定义系统通知 https://api.netease.im/nimserver/msg/sendAttachMsg.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
批量发送自定义系统通知 https://api.netease.im/nimserver/msg/sendBatchAttachMsg.action 单个应用默认最高调用频率:120 次/分,如超限,将被屏蔽 1 分钟。
发送广播消息 https://api.netease.im/nimserver/msg/broadcastMsg.action 单个应用默认最高调用频率:10 次/分,如超限,将被屏蔽 1 分钟。
发送聊天室消息 https://api.netease.im/nimserver/chatroom/sendMsg.action 单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
发送聊天室全服广播消息 https://api.netease.im/nimserver/chatroom/broadcast.action 单个应用默认最高调用频率:10 次/分,如超限,将被屏蔽 1 分钟。
群组管理操作 除发送群消息 API 外,其他所有高级群 API 都属于高级群操作 API。 单个应用中默认 1 秒内所有的高级群操作 API 合计最多可调用 100 次,如超限,将被屏蔽 10 秒。

云信控制台配置频控

  1. 在控制台首页应用管理中选择应用,然后单击 IM 即时通讯下的功能配置按钮进入功能配置页。

    image.png
  2. 顶部选择服务端频控页签,开启需要调整的接口频控。

    开启频控.png

  3. 开启后,可单击编辑,输入频控值。

    后续会根据新设置的频控进行计费。

此文档是否对你有帮助?
有帮助
去反馈
  • 频控说明
  • IM 接口频控
  • 云信 IM 账号管理
  • 消息功能
  • 历史消息与记录
  • 自定义系统通知
  • 用户和好友关系
  • 高级群
  • 超大群
  • 聊天室
  • 在线状态订阅
  • 其他
  • 圈组
  • 调整接口频控