说明:
账户级接口属于仅账户管理员可以使用的接口,是重量级接口,查询的信息量比较大,访问限制:10次/min。
接口描述
描述:获取账户中的所有角色列表,目前暂不支持 OAuth2.0 鉴权访问。
请求方式:GET
自建应用权限点:查看企业角色,管理企业角色。
接口请求域名:
https://api.meeting.qq.com/v1/corp/user-roles?page={page}&page_size={page_size}
输入参数
参数名称 | 必选 | 参数类型 | 参数描述 |
page_size | 是 | Integer | 分页大小。 |
page | 是 | Integer | 当前页。 |
输出参数
参数名称 | 参数类型 | 参数描述 |
current_page | Integer | 当前页。 |
current_size | Integer | 当前页实际大小。 |
total_count | Integer | 数据总条数。 |
total_page | Integer | 数据总页数。 |
user_role_list | UserRoleList 对象数组 | 角色对象列表。 |
UserRoleList 对象
参数名称 | 参数类型 | 参数描述 |
role_code | String | 角色 code。 |
role_name | String | 角色 name。 |
role_desc | String | 角色描述。 |
role_member_nu | String | 具备该角色的用户数。 |
错误码列表
状态码 | 错误码 | 错误描述 |
400 | 190004 | 参数非法,请对照接口文档检查您的参数。 |
500 | 10 | 请求参数不合法。 |
示例
输入示例
GET /v1/corp/user-roles?page_size=20&page=1
输出示例
{"total_count":2,"total_page":1,"current_page":1,"current_size":2,"user_role_list":[{"role_code":"ADMIN_ROLE","role_name":"超级管理员","role_desc":"超级管理员拥有访问和管理企业账户的全部权限","role_member_nu":1},{"role_code":"MANAGER_ROLE","role_name":"管理员","role_desc":"管理员拥有访问和管理企业账户的广泛权限","role_member_nu":1}]}