分页查询频道分组黑白名单成员列表。

URL

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

请求参数

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

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

参数	类型	必须	说明
serverId	Long	是	服务器唯一标识
categoryId	Long	是	频道分组唯一标识
accid	String	否	操作者accid，如果传，则会校验该账号对该频道分组是否有权限，否则不校验
type	Long	是	1表示白名单，2表示黑名单
timetag	Long	是	时间戳，毫秒对应的字符串，0则表示查询最近的一页
limit	Long	是	本次查询的条数上限

返回参数

参数	说明
pageInfo	分页信息，具体成员参数见下表
members	黑名单成员列表或白名单列表，具体成员参数见下表

pageInfo 参数说明如下：

参数	类型	说明
hasMore	Boolean	是否有下一页
nextTimetag	Long	查询下一页时需要传入的时间戳

members 参数说明如下

参数	类型	说明
serverId	Long	成员所属的服务器的 ID
accid	String	成员的 IM 账号
nick	String	成员的昵称
avatar	String	成员的头像的 URL
custom	String	自定义字段
type	Integer	服务器成员类型，0-普通成员，1-所有者
joinTime	Long	成员被加入服务器的时间
inviter	String	邀请该成员的用户的 IM 账号
validFlag	Integer	有效标志，0-无效，1-有效
createTime	Long	创建时间
updateTime	Long	更新时间

示例

cURL 请求示例

curlcurl -X POST -H "AppKey: go9dnk49b**lw0803mgq3" -H "Nonce: 4tgggerg**23t23t" -H "CurTime: 1443592222" -H "CheckSum: 9e9db3b6c9abb2e1962cf3e6f7316fcc55583f86" -H "Content-Type: application/x-www-form-urlencoded" -d 'serverId=1513535&categoryId=12222&type=1&timetag=0&limit=10&accid=acc' 'http://api.netease.im/nimserver/qchat/queryCategoryWhiteBlackIdentifyUserPage.action'

返回示例

json"Content-Type": "application/json; charset=utf-8"
{
    "code": 200,
    "pageInfo": {
        "hasMore": true,  //是否有下一页
        "nextTimetag": 1234  //查询下一页时需要的timetag
    },
    "members": [{
            "serverId": 123,
            "accid": "lisi",
            "nick": "nick",
            "avatar": "avatar",
            "custom": "custom",
            "type": 0,
            "joinTime": 1234,
            "inviter": "zhangsan",
            "validFlag": 1,
            "createTime": 1234,
            "updateTime": 1234
 
 }] //是一个数组，每一项都是一个服务器成员信息
}

状态码

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

200、403、414、416、419、500