# 获取角色

# 接口描述

用于获取主体角色列表

# 请求方法

GET

# 请求地址

https://open.wecard.qq.com/cgi-bin/role/roles?access_token=DLqPGWsLsDMnq232zyCw1StS08HGYRqy

# 参数说明

参数 必填 类型 实例 说明
access_token String DLqPGWsLsDMnq232zyCw1StS08HGYRqy 应用凭证

# 响应说明

{
    "errcode": 0,
    "errmsg": "OK",
    "list": [
        {
            "id": 1,
            "name": "超级管理员",
            "group_id": 1
        },
        {
            "id": 2,
            "name": "子管理员",
            "group_id": 1
        }
    ]
}
参数 必填 类型 实例 说明
errcode Integer 0 状态码,0为成功,非0为错误
errmsg String success 状态描述信息
list id Integer 0 角色id
name String 超级管理员 角色名称
group_id Integer 1 角色组id

# 注意事项

  1. access_token的获取参考获取应用有效凭证
  2. 角色列表需定时更新,推荐每日进行一次全量更新。

# 更新日志

日期 变更说明
2020-05-08 新文档上线