# 获取权限组详情

# 接口描述

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

# 请求方法

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 文档上线