API 参考
圈组

频道分组用户定制权限

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

本文介绍如何通过服务端 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 的设置如下:

参数
类型
必须
说明
accidString操作者accid
serverIdString服务器唯一标识
categoryIdString频道分组的唯一标识
targetAccidString被操作的用户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 的设置如下:

参数
类型
必须
说明
accidString操作者accid
serverIdString服务器唯一标识
categoryIdString频道分组的唯一标识
targetAccidString被删除的用户的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 的设置如下:

参数
类型
必须
说明
accidString操作者accid
serverIdString服务器唯一标识
categoryIdString频道分组的唯一标识
targetAccidString被修改的用户的accid
authsString

用于修改权限的 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 的设置如下:

参数
类型
必须
说明
accidString操作者accid
serverIdString服务器唯一标识
categoryIdString频道分组的唯一标识
timetagString分页的起始timetag
limitString每页限制查询的数量,不传时默认为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状态表

此文档是否对你有帮助?
有帮助
去反馈
  • 创建频道分组下某人的定制权限
  • URL
  • 请求参数
  • 示例
  • curl请求示例
  • 返回示例
  • 状态码
  • 删除频道分组下某人的定制权限
  • URL
  • 请求参数
  • 示例
  • curl请求示例
  • 返回示例
  • 状态码
  • 修改频道分组下某人的定制权限
  • URL
  • 请求参数
  • 示例
  • curl请求示例
  • 返回说明
  • 状态码
  • 分页查询频道分组下某人的定制权限
  • URL
  • 请求参数
  • 示例
  • curl请求示例
  • 返回示例
  • 状态码