api:api_permission_roles

拉取企业QQ的角色列表

拉取企业QQ的角色列表

请求地址

https://openapi.b.qq.com/api/permission/roles

请求方式

GET

请求样例

请求频率

100次/分钟(详见频率限制)

请求参数

所有向企业QQ发起的请求均包含该公共参数

此请求不需要其他参数

字段名称 字段类型 字段说明

返回结果

{
  "ret": 0,
  "msg": "调用成功",
  "data": {
    "1": {
      "id": 1,
      "name": "系统管理员",
      "remark": "系统管理员可多人,其默认拥有组织架构和角色的管理权限,通常适用于企业内的行政、人事和网管等人员"
    },
    "2": {
      "id": 2,
      "name": "信息管理员",
      "remark": "信息管理员可多人,其默认拥有信息管理范围内的成员信息查看权限,通常适用于企业的部门管理人员"
    },
    "4": {
      "id": 4,
      "name": "普通员工",
      "remark": "普通成员可多人,其默认拥有外部沟通和广播的权限,通常适用于企业普通员工"
    },
    "16777216": {
      "id": 16777216,
      "name": "企业管理员",
      "remark": "企业管理员可多人,其默认拥有全部权限,通常适用于企业高层管理人员"
    }
  }
}
字段名称 字段类型 字段说明
ret int 返回码:0 正常, >0 异常
msg string 如果ret不为0,会有相应的错误信息提示,UTF-8编码。
data object 以角色的ID为键,值为角色基本信息的键值对(object)

角色对象:

字段名称 字段类型 字段说明
id int 角色ID
name string 角色名称
remark string 角色备注信息,描述了角色的作用和功能等

返回

api/api_permission_roles.txt · 最后更改: 2016/04/22 16:55 (外部编辑)