查询用户权限
更新时间: 2025/08/25 15:56:39
查询某人是否拥有指定服务器或者指定服务器下某个频道的某些权限(包括自定义权限,相关 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 中返回请求的状态码,状态码列表请参考 状态码。
此文档是否对你有帮助?