拉取登录身份绑定的应用自定义角色
使用场景： 用户登录后支持拉取用户身份所绑定的应用自定义角色
权限说明
| 权限项 | 说明 | 备注 |
|---|---|---|
| 应用是否需要申请白名单 | 不需要 | |
| 用户凭证 | 支持 | |
| 机构凭证 | 不支持 | - |
请求方式： GET（HTTPS）
请求地址： https://oapi.epaas.qq.com/suite/get_user_app_roles
Query参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| access_token | string | 是 | 接口调用凭证 |
返回参数：
| 参数 | 类型｜说明 | |
|---|---|---|
| errcode | int32 | 返回码，0为正常 |
| errmsg | string | 对返回码的文本描述内容 |
| app_role_list.role_id | uint32 | 应用角色唯一id |
| app_role_list.role_name | string | 应用角色名称 |
| app_role_list.role_description | string | 应用角色描述 |
示例：
请求示例
GET https://oapi.epaas.qq.com/suite/get_user_app_roles?access_token=ACCESS_TOKEN
返回结果：
{
"errcode": 0,
"errmsg": "ok",
"app_role_infos": [
{
"app_role_id": "open_role_700259_312",
"app_role_name": "管理员",
"app_role_description": "应用的维护和管理人员",
"app_role_users": [
{
"nickname": "test",
"userid": 30010660
}
],
"app_role_departments": [
{
"department_name": "DYG",
"department_id": 3030324
},
{
"department_name": "Hero久竞",
"department_id": 3032585
}
]
}
]
}
拉取应用自定义角色信息
使用场景： 根据Token中应用Id和机构Id拉取全部自定义角色及用户信息列表
权限说明
| 权限项 | 说明 | 备注 |
|---|---|---|
| 应用是否需要申请白名单 | 不需要 | |
| 用户凭证 | 支持 | |
| 机构凭证 | 未支持 | - |
请求方式： GET（HTTPS）
请求地址： https://oapi.epaas.qq.com/suite/get_custom_roles
Query参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| access_token | string | 是 | 接口调用凭证 |
返回参数：
| 参数 | 类型｜说明 | |
|---|---|---|
| errcode | int32 | 返回码，0为正常 |
| errmsg | string | 对返回码的文本描述内容 |
| app_role_infos.app_role_id | int32 | 应用角色唯一id |
| app_role_infos.app_role_name | string | 应用角色名称 |
| app_role_infos.app_role_description | string | 应用角色描述 |
| app_role_infos.app_role_users.nickname | string | 该角色所关联用户姓名 |
| app_role_infos.app_role_users.userid | uint32 | 该角色所关联用户Id |
| app_role_infos.app_role_departments.department_name | string | 该角色所关联部门名称 |
| app_role_infos.app_role_departments.department_id | uint32 | 该角色所关联部门Id |
示例：
请求示例
GET https://oapi.epaas.qq.com/suite/get_custom_roles?access_token=ACCESS_TOKEN
返回结果：
{
"errcode": 0,
"errmsg": "ok",
"app_role_infos": [
{
"app_role_id": "open_role_700259_312",
"app_role_name": "管理员",
"app_role_description": "应用的维护和管理人员",
"app_role_users": [
{
"nickname": "test",
"userid": 30010660
}
],
"app_role_departments": [
{
"department_name": "DYG",
"department_id": 3030324
},
{
"department_name": "Hero久竞",
"department_id": 3032585
}
]
}
]
}
设置应用自定义角色信息
使用场景： 为自定义角色添加关联用户。
权限说明
| 权限项 | 说明 | 备注 |
|---|---|---|
| 应用是否需要申请白名单 | 不需要 | |
| 用户凭证 | 支持 | |
| 机构凭证 | 未支持 | - |
请求方式： POST（HTTPS）
请求地址： https://oapi.epaas.qq.com/suite/set_custom_role_users
Query参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| access_token | string | 是 | 接口调用凭证 |
Body参数：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| suiteid | string | 是 | 应用id |
| corpid | string | 是 | 机构id |
| app_role_id | int32 | 是 | 应用角色唯一id |
| app_role_users.nickname | string | 否 | 该角色所关联用户姓名 |
| app_role_users.userid | uint32 | 否 | 该角色所关联用户Id |
| app_role_departments.department_name | string | 否 | 该角色所关联部门名称 |
| app_role_departments.department_id | uint32 | 否 | 该角色所关联部门Id |
返回参数：
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 返回码 |
| errmsg | string | 对返回码的文本描述内容 |
示例：
请求示例
POST https://oapi.epaas.qq.com/suite/set_custom_role_users?access_token=ACCESS_TOKEN
请求包体：
{
"suiteid":700259,
"corpid":894000,
"app_role_id":"open_role_700259_312",
"app_role_users":[
{
"nickname":"test",
"userid":30010660
}
],
"app_role_departments":[
{
"department_name":"DYG",
"department_id":3030324
},
{
"department_name":"Hero久竞",
"department_id":3032585
}
]
}
返回结果：
{
"errcode":0,
"errmsg":"ok"
}