简体中文
修改成员
约 477 字大约 2 分钟
2026-10-23
描述
修改成员
请求说明
请求方式 :POST + application/json
请求路径 :https://${填入所在云的域名}/cgi/user/update?thirdTraceId=${随机字符串}
请求头填写 :参考公共参数填写
请求参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| user | Map | 是 | 部门ID |
| openUserId | String | 是 | 员工ID |
| account | String | 否 | 员工账号(不能重复),不传表示不修改 |
| name | String | 否 | 员工昵称(不能重复),不传表示不修改 |
| fullName | String | 否 | 员工姓名,不传表示不修改 |
| position | String | 否 | 职位,不传表示不修改 |
| gender | String | 否 | 性别 可取{M,F},不传表示不修改 |
| mobile | String | 否 | 手机号码(不能重复),不传表示不修改 |
| String | 否 | 邮箱地址,不传表示不修改 | |
| String | 否 | qq号,不传表示不修改 | |
| weixin | String | 否 | 微信号,不传表示不修改 |
| mainDepartmentId | Int | 否 | 主属部门Id |
| attachingDepartmentIds | List | 否 | 附属部门列表(int集合必须为非负数整数,最大值为:500,不传表示不修改) |
| employeeNumber | String | 否 | 员工编号,若企业开启系统名允许重复,该字段必填 |
| hireDate | String | 否 | 入职日期 |
| birthDate | String | 否 | 员工生日 |
| startWorkDate | String | 否 | 参加工作日期 |
| leaderId | String | 否 | 汇报对象 |
请求示例
{
"user": {
"openUserId": "fsuid_openId2",
"account": "",
"name": "xx-name",
"fullName": "xxx-fullName",
"position": "经理",
"gender": "M",
"mobile": "15845698456",
"email": "xxx@fxiaoke.com",
"qq": "45682156",
"weixin": "15010478956",
"mainDepartmentId": "",
"attachingDepartmentIds": [
1.0,
2.0,
3.0
],
"employeeNumber": "168XXXX123",
"hireDate": "1504173600000",
"birthDate": "1504627199000",
"startWorkDate": "1504173600000",
"leaderId": "FSUID_XXXXXXXXXXXXXXXXXXX"
}
}返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| dataId | String | 数据ID |
| traceId | string | 请求唯一ID |
| errorDescription | string | 错误描述 |
| errorMessage | string | 错误信息 |
| errorCode | Int | 查看错误码 |
返回示例
{
"dataId": "68faxxxxxx",
"traceId": "E-O.827xxxxxx",
"errorDescription": "success",
"errorMessage": "OK",
"errorCode": 0
}注意事项
- 不能使用返回值的message字段做逻辑判断,errorMessage会有变化;
