获取权限组详情

接口描述

用于获取某个权限组的详情，仅当该权限组拥有应用的权限时能调用成功

请求方法

POST(application/json)

请求地址

https://open.wecard.qq.com/cgi-bin/permission/group?access_token=access_token

参数说明

{
    "group_id": "916"
}

参数	必填	类型	实例	说明
access_token	是	String	ACCESS_TOKEN	应用的有效凭证
group_id	是	Integer	916	权限组id

响应说明

错误时返回

{
    "errcode": 0,
    "errmsg": "ok"
}

正确时返回

{
    "errcode": 0,
    "errmsg": "ok",
    "group": {
        "id": "916",
        "name": "腾讯微卡大学超级管理员",
        "parent_id": "0",
        "disable": "false",
        "managers": [
            {
                "name": "陈老师",
                "card_number": "51447",
            }
        ]
    }
}

参数			必填	类型	实例	说明
errcode			是	Integer	0	状态码，0表示正常
errmsg			是	String	ok	状态码描述
group	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	更新时间
	managers	name	是	String	陈老师	用户姓名，若用户未完成腾讯微卡实名认证，则返回微信昵称
		card_number	是	String	51447	用户电子卡号，若用户未完成腾讯微卡实名认证，则返回空

注意事项

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

更新日志

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