# 获取权限组

# 接口描述

用于应用获取管理员权限组列表,仅返回拥有该应用权限的权限组列表。若某个子级有权限,但对应父级无权限,则会返回相应的父级。

# 请求方法

POST(application/json)

# 请求地址

https://open.wecard.qq.com/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 更新时间

# 注意事项

  1. 私有化部署的主体不能使用上面接口地址,需要根据主体私有化部署域名拼上对应的路径,主体私有化网关域名(私有化部署域名+/kong)
  2. access_token的获取参考获取应用有效凭证
  3. 主体权限组需定时更新,推荐每日进行一次全量更新。

# 更新日志

日期 变更说明
2019-10-18 文档上线