云信支持查询当前服务器或频道中的临时禁言成员列表。

前提限制

使用圈组临时禁言功能需要相关权限，请提前开启身份组权限项中的 禁言/临时禁言管理（QChatRoleResource.MUTE）。

URL

POST  http://api.netease.im/nimserver/qchat/queryMuteMembersPage.action  HTTP/1.1
Content-Type: application/x-www-form-urlencoded;charset=utf-8

请求参数

• POST 请求中 Headers 的设置请参考 API 调用方式。

• POST 请求中 Body 的设置如下：

参数	类型	必须	说明
operatorAccountId	String	是	操作者用户帐号 ID操作者需要拥有临时禁言他人的权限，否则将返回 403 错误码。权限相关配置请参见 修改服务器身份组。
serverId	Long	是	服务器 ID
channelId	Long	否	频道 ID
muteLevel	Integer	是	临时禁言的维度，1-服务器、2-频道
pageToken	String	否	分页参数，使用上一次请求成功返回的分页标识
limit	Integer	否	本次查询的数量上限，单次最多返回 100 个禁言用户

示例

cURL 请求示例

curl -X POST -H "AppKey: go9dnk49**803mgq3" -H "Nonce: 4tggg**323t23t" -H "CurTime: 1443592222" -H "CheckSum: 9e9db3b6c9abb**316fcc55583f86" -H "Content-Type: application/x-www-form-urlencoded" -d 'serverId=1513535&operatorAccountId=zhangsan&muteLevel=1' 'http://api.netease.im/nimserver/qchat/queryMuteMembersPage.action'

返回参数

参数	类型	说明
code	Integer	状态码
data	Array of objects	被临时禁言的用户信息，具体字段信息见下表
pageInfo	Object	分页信息，具体见下表

pageInfo 字段	类型	说明
hasMore	Boolean	是否有下一页
nextPageToken	String	分页标识

data 字段	类型	说明
accountId	String	用户账号 ID
serverId	String	服务器 ID
channelId	String	频道 ID
muteOperateTime	Long	被临时禁言的操作时间戳
duration	Long	被临时禁言的持续时间
beReleaseTime	Long	自动解除禁言的时间戳
nick	String	用户昵称
avatar	String	用户头像

返回示例

"Content-Type": "application/json; charset=utf-8"
{
    "code":200,
    "data":[
        {
            "accountId":"111111",
            "serverId":11111,
            "channelId":11112222,
            "muteOperateTime":1324345332,
            "duration":100, //禁言持续时长，单位：秒
            "beReleaseTime":11131312324, //将要解除禁言的时间点
            "nick":"sfsfagsdasd" //昵称，
            "avatar":"2435fzsfsds",//操作人头像
        }    
    ],
    "pageInfo":{
        "hasMore":true,
        "nextPageToken":"dsfdsfsdf"    
    }
}

状态码

该接口在 HTTPS Body 中返回请求的状态码，以下仅列出与接口业务强相关的状态码。完整状态码请参见 状态码。

200、403、404、414、416、431