获取权限组

接口描述

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

请求方法

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的获取参考获取应用有效凭证 (opens new window)。
3. 主体权限组需定时更新，推荐每日进行一次全量更新。

更新日志

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