编辑员工信息
POST https://qw-openapi-tx.dustess.com/open-integration-api/employee/v1/editEmployeeInfo?accessToken=
Content-Type: application/json
字段 | 类型 | 描述 | 是否必须 |
---|---|---|---|
accessToken | String | accessToken | true |
请求参数名 | 类型 | 说明 | 是否必须 |
---|---|---|---|
list | Object[] | 编辑列表,单次最多更新30条 | true |
list.uId | String | 员工id | true |
list.mobile | String | 员工手机号(不编辑此数据,请不要传该字段。且与cusEmpCode不能同时不传,手机号不能设为空字符串) | false |
list.cusEmpCode | String | 员工自定义编号 (不编辑此数据,请不要传该字段。且与mobile不能同时不传) | false |
json
- Request-Example://eg.1 只编辑手机号
{
"list": [{
"uId": "1797",
"mobile": "18200215551"
//"mobile": "" 手机号设置为空字符串是不允许的
}]
}
//eg.2 只编辑自定义
{
"list": [{
"uId": "1797",
"cusEmpCode": "5251"
//"cusEmpCode": "" 自定义字段可设置为空字符串
}]
}
//eg.3 同时编辑手机号和自定义编号
{
"list": [{
"uId": "1797",
"mobile": "18200215551",
"cusEmpCode": "5522"
}]
}
响应参数名 | 类型 | 说明 |
---|---|---|
success | Bool | 请求状态,true:成功,false:失败_Allowed values: true,false_ |
code | Int | 响应代码 |
msg | String | 消息提示 |
data | Object | 数据信息 |
data.successList | Object[] | 更新成功列表 |
data.successList.uId | String | 员工id |
data.failList | Object[] | 更新失败列表 |
data.failList.uId | String | 员工id |
data.failList.code | Int | 更新错误码 |
data.failList.msg | String | 更新错误信息 |
{
"success": true,
"code": 0,
"msg": "OK",
"data": {
"successList": [{
"uId": "1797",
}],
"failList": [{
"uId": "1706",
"code": 500511,
"msg": "手机号格式有误"
}]
}
}
{
"success": false,
"code": 10001,
"msg": "system unknown error",
"data": null
}
修改于 2024-09-20 09:55:45