修改成员接口调试
1. 简介
1.1 接口简介
修改指定成员的信息,比如部门、昵称。仅支持公共模式。
1.2 接口版本
接口版本 | 更新时间 | 版本说明 |
v1 | 2018.12.4 | 使用 _id 作为 id |
v2 | 2019.6.21 | 使用 username 作为 id |
v4 | 2022.6.30 | 返回值新增字段 type、status、integrate_id |
v5 | 2022.10.28 | 在 v4 的基础上,接口请求频率由 5 次/秒提升至 20 次/秒; 参数 username 放入body,接口路由修改为 POST corp/user/update |
2. 接口调用
修改指定成员的信息,比如部门、昵称。仅支持公共模式。
注:成员编号不允许修改。
请求地址:https://api.jiandaoyun.com/api/v5/corp/user/update
请求频率:20 次/秒
请求方式:POST
请求参数:
参数 | 是否必需 | 类型 | 说明 |
username | 是 | String | 成员编号 |
name | 否 | String | 昵称 |
departments | 否 | Number[] | 用户所属部门列表 |
请求示例:
{
"username": "jiandaoyun",
"name": "小云",
"departments": [4]
}
响应内容:
参数 | 类型 | 说明 |
user | Json | 修改后的该成员信息,同 单个成员的返回数据结构。 |
响应示例:
{
"user": {
"username": "jiandaoyun",
"name": "小云",
"departments": [1,3],
"type": 0,
"status": 1
}
}