聊天室踢人
更新时间: 2024/07/17 17:57:35
聊天室踢人出群,需要提供聊天室 ID roomid
、操作者账号 accid
和被踢人的账号 targetAccid
。
只有聊天室创建者和管理员才能踢人出聊天室。
API 使用限制
单个应用默认最高调用频率:100 次/秒,如超限,将被屏蔽 10 秒。
URL
POST https://api.netease.im/nimserver/chatroom/kickMember.action HTTP/1.1
Content-Type: application/x-www-form-urlencoded;charset=utf-8
请求参数
- POST 请求中 Headers 的设置请参考API 调用方式。
- POST 请求中 Body 的设置如下:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
roomid | String | 是 | 聊天室 ID |
targetAccid | String | 是 | 目标用户账号,即被踢的用户账号 |
accid | String | 是 | 操作者账户,只有聊天室创建者和管理员才能踢人出聊天室 |
notifyExt | String | 否 | 扩展字段 |
示例
请求示例(curl)
curlcurl -X POST -H "AppKey: go9dnk4***03mgq3" -H "Nonce: 4tggg**323t23t" -H "CurTime: 1443592222" -H "CheckSum: 9e9db3b6c***fcc55583f86" -H "Content-Type: application/x-www-form-urlencoded" -d 'roomid=36&targetAccid=wmtest154&accid=wujie¬ifyExt=xxxx' 'https://api.netease.im/nimserver/chatroom/kickMember.action'
请求成功返回示例
json"Content-Type": "application/json; charset=utf-8"
{
"code":200
}
请求失败返回示例
"Content-Type": "application/json; charset=utf-8"
{
"code": 414, // 参数错误
"desc": "xxxx is empty"
}
状态码
该接口在 HTTPS Body 中返回请求的状态码,以下仅列出与接口业务相关的状态码。完整状态码请参见状态码。
此文档是否对你有帮助?