更新一个自建角色调试
1. 简介
1.1 接口简介
对自建角色进行更新。支持公共模式和集成模式, 但集成模式下只支持对自建角色的操作,不支持对第三方同步过来的角色操作。
1.2 接口版本
接口版本 | 更新时间 | 版本说明 |
v2 | 2022.4.8 | 初始版本:
|
v4 | 2022.6.30 | 返回值新增字段 status |
v5 | 2022.10.28 | 在 v4 的基础上,接口请求频率由 5 次/秒提升至 20 次/秒; 接口路由修改为 POST corp/role/update |
2. 接口调用
请求地址:https://api.jiandaoyun.com/api/v5/corp/role/update
请求频率:20 次/秒
请求方式:POST
请求参数:
参数 | 类型 | 是否必需 | 说明 |
role_no | Number | 是 | 角色编号 |
group_no | Number | 是 | 角色组编号 |
name | String | 否 | 角色名称 |
请求示例:
{
"role_no": 2558,
"group_no": 2547,
"name": "研发部门"
}
响应内容:
参数 | 类型 | 是否必需 | 说明 |
role_no | Number | 是 | 角色编号 |
group_no | Number | 否 | 角色组编号 |
name | String | 是 | 角色名称 |
type | Number | 是 | 角色类型:
|
status | Number | 是 | 成员状态:
|
integrate_id | String | 否 | 集成模式同步角色关联 ID,仅在集成模式下返回 |
返回示例:
{
"role": {
"role_no": 2558,
"group_no": 2547,
"name": "研发部门",
"type": 0,
"status": 1
}
}