频道分组用户定制权限
更新时间: 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 的设置如下:
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
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}。
注:单次最多可批量修改权限数为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状态表
此文档是否对你有帮助?