圈组

查询用户权限

更新时间: 2025/11/13 17:11:40

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

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

请求信息

请求 URI

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

请求头参数

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

请求体参数

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

请求示例

cURLcurl -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.yunxinapi.com/nimserver/qchat/queryIdentifyResources.action'

响应信息

响应参数

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

响应示例

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

状态码

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

此文档是否对你有帮助?
有帮助
去反馈
  • 请求信息
  • 请求 URI
  • 请求头参数
  • 请求体参数
  • 请求示例
  • 响应信息
  • 响应参数
  • 响应示例
  • 状态码