为自建角色批量移除成员调试
1. 简介
1.1 接口简介
将成员从角色中批量移除。支持公共模式和集成模式, 但集成模式下只支持对自建角色的操作。
1.2 接口版本
接口版本 | 更新时间 | 版本说明 |
v2 | 2022.4.8 | 初始版本:
|
v4 | 2022.6.30 | 返回值新增字段 status |
v5 | 2022.10.28 | 在 v4 的基础上,接口请求频率由 5 次/秒提升至 10 次/秒; 接口路由修改为 POST corp/role/remove_members |
2. 接口调用
将成员从角色中批量移除。支持公共模式和集成模式, 但集成模式下只支持对自建角色的操作。
请求地址:https://api.jiandaoyun.com/api/v5/corp/role/remove_members
请求频率:10 次/秒
请求方式:POST
请求参数:
参数 | 类型 | 是否必须 | 说明 |
role_no | Number | 是 | 角色编号,示例:3 |
usernames | String[] | 是 | 员工工号 |
请求示例:
{
"role_no": 3,
"usernames": [
"fr0005",
"fr008"
]
}
响应内容:
参数 | 类型 | 是否必须 | 说明 |
status | String | 否 | 返回请求结果 |
返回示例:
{
"status": "success"
}