# 获取权限组
# 接口描述
用于应用获取管理员权限组列表,仅返回拥有该应用权限的权限组列表。
# 请求方法
POST(application/json)
# 请求地址
https://uni.weixiao.qq.com/open/cgi-bin/permission/group-list
注:若私有化部署,接口地址域名变更私有化域名
# 参数说明
{
"access_token": "ACCESS_TOKEN",
"page": "1",
"page_size": "10"
}
参数 | 必填 | 类型 | 实例 | 说明 |
---|---|---|---|---|
ACCESS_TOKEN | 是 | String | 应用的有效凭证 | |
page | 是 | Integer | 1 | 页数 |
page_size | 是 | Integer | 10 | 每页条数 |
# 响应说明
{
"errcode": 0,
"errmsg": "ok",
"page": "1",
"page_size": "10",
"total": "2",
"groups": [
{
"id": "916",
"name": "腾讯微卡大学超级管理员",
"parent_id": "0",
"disable": "fasle",
"updated_at": "2019-08-21 10:00:00",
},
{
"id": "2332",
"name": "普通管理员",
"parent_id": "916",
"disable": "true",
"updated_at": "2019-08-21 10:00:00"
}
]
}
参数 | 必填 | 类型 | 实例 | 说明 | |
---|---|---|---|---|---|
errcode | 是 | Integer | 0 | 状态码,0表示正常 | |
errmsg | 是 | String | ok | 状态码描述 | |
page | 是 | Integer | 20 | 当前页数 | |
page_size | 是 | Integer | 20 | 当前页数据条数 | |
total | 是 | Integer | 20 | 数据总数 | |
groups | id | 是 | Integer | 916 | 管理员权限组id |
name | 是 | String | 腾讯微卡大学超级管理员 | 角色名称 | |
parent_id | 是 | Integer | 0 | 父级权限组id,当为0时该节点为顶级 | |
disable | 是 | Boolean | false | 权限组是否拥有该应用权限,为true时,表示无权限,无法获取详情,应该置灰 | |
update_at | 是 | Datetime | 2019-08-21 10:00:00 | 更新时间 |
# 注意事项
- 私有化部署的主体不能使用上面接口地址,需要根据主体私有化部署域名拼上对应的路径。
- access_token的获取参考获取应用有效凭证 (opens new window)。
- 主体权限组需定时更新,推荐每日进行一次全量更新。
# 更新日志
日期 | 变更说明 |
2019-10-18 | 文档上线 |