API 参考
圈组

查询用户权限

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

查询某人是否拥有指定服务器或者指定服务器下某个频道的某些权限(包括自定义权限,相关API说明请参见身份组自定义权限)。

单次最多可查询 10 个权限。

URL

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

请求参数

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

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

参数
类型
是否必传 说明
accid String 待查询用户的云信 IM 账号
serverId long 服务器唯一标识
channelId long 频道唯一标识,如果不填则表示查询服务器权限
resources String 可以转成 JSON 数组,每一项表示一个权限,最多10个。resource 的具体定义,请参见更新服务器身份组中对于 auths 参数的说明。

返回参数

参数 类型 说明
code int 状态码
isAllowResources String 由“权限枚举值”和“是否拥有权限”组成的 JSON 数组

示例

cURL 请求示例

curl -X POST -H "AppKey: go9dnk49b*****9vmel1kglw0803mgq3" -H "Nonce: 4tgggergigwow323t23t" -H "CurTime: 1443592222" -H "CheckSum: 9e9db3b6c9abb2e1962c*****7316fcc55583f86" -H "Content-Type: application/x-www-form-urlencoded" -d 'serverId=1513535&channelId=1513535&accid=zhangsan&resources=%5B%2216%22%2C%2218%22%5D' 'http://api.netease.im/nimserver/qchat/queryIdentifyResources.action'

返回示例

"Content-Type": "application/json; charset=utf-8"
{
    "code": 200,
    "isAllowResources": [
        {
            "resource": 1,  //权限枚举值
            "isAllow": true //是否有权限
        },
        {
            "resource": 2,
            "isAllow": true
        },
        {
            "resource": 3,
            "isAllow": true
        }
    ]
}

状态码

该接口在 HTTPS Body 中返回请求的状态码,状态码列表请参考状态码

此文档是否对你有帮助?
有帮助
去反馈
  • URL
  • 请求参数
  • 返回参数
  • 示例
  • cURL 请求示例
  • 返回示例
  • 状态码