本文介绍如何通过服务端 API 管理频道分组下的用户定制权限，具体包含如下 API：

• 创建频道分组下某人的定制权限
• 删除频道分组下某人的定制权限
• 修改频道分组下某人的定制权限
• 分页查询频道分组下某人的定制权限

创建频道分组下某人的定制权限

在频道分组下为某个人定制权限。

URL

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

请求参数

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

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

参数	类型	必须	说明
accid	String	是	操作者accid
serverId	String	是	服务器唯一标识
categoryId	String	是	频道分组的唯一标识
targetAccid	String	是	被操作的用户accid

示例

curl请求示例

curlcurl -X POST -H "AppKey: go9d**w0803mgq3" -H "Nonce: 4tgg**t23t" -H "CurTime: 1443592222" -H "CheckSum: 9e9db3b6c9abb2e1962cf3e6f7316fcc55583f86" -H "Content-Type: application/x-www-form-urlencoded" -d 'serverId=1513535&accid="accid"&categoryId=10010&targetAccid="faccid"' 'http://api.netease.im/nimserver/qchat/createChannelCategoryUserIdentify.action'

返回示例

http 响应:json

json"Content-Type": "application/json; charset=utf-8"
{
    "code": 200,
    "identify": {
        "serverId": 2,
        "categoryId": 1,
        "createtime": 1,
        "accid": "accid",
        "auths": "{\"1\":-1, \"2\":1}",
        "avatar": "name",
        "inviter": "icon",
        "joinTime": 1,
        "nick": "icon",
        "memberType": 1,
        "custom": "icon",
        "updatetime": 1
    }
}

状态码

200、403、414、416、431、500

具体请参考code状态表

删除频道分组下某人的定制权限

删除频道分组下某人的定制权限。

URL

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

请求参数

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

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

参数	类型	必须	说明
accid	String	是	操作者accid
serverId	String	是	服务器唯一标识
categoryId	String	是	频道分组的唯一标识
targetAccid	String	是	被删除的用户的accid

示例

curl请求示例

curlcurl -X POST -H "AppKey: go9dnk49b**3mgq3" -H "Nonce: 4tgggerg**3t23t" -H "CurTime: 1443592222" -H "CheckSum: 9e9db3b6c9abb2e1962cf3e6f7316fcc55583f86" -H "Content-Type: application/x-www-form-urlencoded" -d 'serverId=1513535&accid="accid"&categoryId=10010&targetAccid="faccid"' 'http://api.netease.im/nimserver/qchat/deleteChannelCategoryUserIdentify.action'

返回示例

http 响应:json

json"Content-Type": "application/json; charset=utf-8"
{
    "code":200
}

状态码

200、403、414、416、431、500

具体请参考code状态表

修改频道分组下某人的定制权限

修改频道分组下某人的定制权限。

URL

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

请求参数

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

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

参数	类型	必须	说明
accid	String	是	操作者accid
serverId	String	是	服务器唯一标识
categoryId	String	是	频道分组的唯一标识
targetAccid	String	是	被修改的用户的accid
auths	String	是	用于修改权限的 JSON 字段, 其格式为 {resource1:type1,resource2:type2,resource3:type3}。 resource 表示权限, 其取值代表的具体权限如下： 2：管理频道的权限，拥有该权限可创建、修改或删除频道 3：管理角色的权限，拥有该权限可创建、修改或删除身份组 4：发送消息的权限 9：撤回他人消息的权限 10：删除他人消息的权限 11：@ 他人的权限，拥有该权限可在发送消息时@他人 12：@ 所有人的权限，拥有该权限可在发送消息时@所有人 13：管理频道黑白名单的权限，拥有该权限可将服务器成员加入或移出频道黑名单 15：实时互动频道：建立自己连接的权限 16：实时互动频道：断开他人连接的权限 17：实时互动频道：开启自己麦克风的权限 18：实时互动频道：开启自己摄像头的权限 19：实时互动频道：开启/关闭他人麦克风的权限 20：实时互动频道：开启/关闭他人摄像头的权限 21：实时互动频道：开启/关闭全员麦克风的权限 22：实时互动频道：开启/关闭全员摄像头的权限 23：实时互动频道：打开自己屏幕共享的权限 24：实时互动频道：关闭他人屏幕共享的权限 27: @身份组的权限，拥有该权限可在发送消息时@指定几个身份组的所有成员 type 表示操作类型，其取值代表的操作如下： -1：关闭权限（deny） 1：开启权限（allow） 0: 继承服务器身份组的权限的开启/关闭状态 注：单次最多可批量修改权限数为12。

示例

curl请求示例

curlcurl -X POST -H "AppKey: go9dnk49bkd**3mgq3" -H "Nonce: 4tg**w323t23t" -H "CurTime: 1443592222" -H "CheckSum: 9e9db3b6c9abb2e1962cf3e6f7316fcc55583f86" -H "Content-Type: application/x-www-form-urlencoded" -d 'serverId=1513535&accid="accid"&categoryId=10010&targetAccid="faccid"&auths="{\"1\":1}"' 'http://api.netease.im/nimserver/qchat/updateChannelCategoryUserIdentify.action'

返回说明

http 响应:json

json"Content-Type": "application/json; charset=utf-8"
{
    "code": 200,
    "identify": {
        "serverId": 2,
        "categoryId": 1,
        "createtime": 1,
        "accid": "accid",
        "auths": "{\"1\":-1, \"2\":1}",
        "avatar": "name",
        "inviter": "icon",
        "joinTime": 1,
        "nick": "icon",
        "memberType": 1,
        "custom": "icon",
        "updatetime": 1
    }
}

状态码

200、403、414、416、431、500

具体请参考code状态表

分页查询频道分组下某人的定制权限

分页查询频道分组下某人的定制权限。

URL

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

请求参数

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

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

参数	类型	必须	说明
accid	String	是	操作者accid
serverId	String	是	服务器唯一标识
categoryId	String	是	频道分组的唯一标识
timetag	String	否	分页的起始timetag
limit	String	否	每页限制查询的数量，不传时默认为200条，最大为200

示例

curl请求示例

curlcurl -X POST -H "AppKey: go9dnk49**3mgq3" -H "Nonce: 4tggg**3t23t" -H "CurTime: 1443592222" -H "CheckSum: 9e9db3b6c9abb2e1962cf3e6f7316fcc55583f86" -H "Content-Type: application/x-www-form-urlencoded" -d 'serverId=1513535&accid="accid"&categoryId=10010&timetag=11111111111&limit=20' 'http://api.netease.im/nimserver/qchat/getChannelCategoryUserIdentify.action'

返回示例

http 响应:json

json"Content-Type": "application/json; charset=utf-8"
{
    "code":200,
    "identifies":[{
        "serverId": 2,
        "categoryId": 1,
        "createtime": 1,
        "accid": "accid",
        "auths": "{\"1\":-1, \"2\":1}",
        "avatar": "name",
        "inviter": "icon",
        "joinTime": 1,
        "nick": "icon",
        "memberType": 1,
        "custom": "icon",
        "updatetime": 1
    }]
}

状态码

200、403、414、416、431、500

具体请参考code状态表