对指定部门更新组织架构信息 注意: 以departmentCode为主键进行更新,如果需要更新departmentCode时,需要传入departmentId,将以departmentId为主键更新departmentCode。
HTTP请求
POST https://api.mokahr.com/api-platform/v2/departments
请求body参数
字段 | 必填 | 类型 | 描述 |
---|---|---|---|
departments | 是 | array | 部门数据 |
departments[].name | 是 | string | 部门名称 |
departments[].departmentCode | 是 | string | 客户系统的部门id |
departments[].parentCode | 是 | string | 部门的上级部门的唯一 id, 如为一级部门传“0” |
departments[].type | 否 | number | 部门类型: |
departments[].departmentId | 否 | number | 部门在Moka系统中的id,此参数存在时,会优先匹配该参数的部门。 |
departments[].sequence | 否 | number | 指定部门排序,支持0至10000的两位小数,为空默认排在最后。按排序从小到大,创建时间从先到后排序 |
返回json字段
字段 | 类型 | 描述 |
---|---|---|
code | number |
|
msg | string | 操作失败的错误原因 |
可能的错误信息
errorMessage | 描述 |
---|---|
当前有未处理完的组织架构更新,请稍后再试 | |
部门名称: XXX, 编号XXX的部门编号重复 | 请求列表中存在重复部门数据或者请求列表中存在于已同步至系统的部门中存在重复 |
父级部门未找到 | 部门的父级部门未在列表中找到 |
部门的父级部门不能直接(间接)为自身 | 部门的父级部门(的父级部门...)不能为自身 |
部门名称XXX,父编号XXX的部门名称已存在 | 某部门下存在相同名称的部门 |
... |
请求样例
curl 'https://api.mokahr.com/api-platform/v2/departments' \
-X POST \
-u 'your_api_keys' \
-d '{ "departments": [ { "departmentCode": "ididid111123", "name": "namenamename1221", "parentCode": null, "sequence": 0 }, { "departmentCode": "ididid211123", "name": "namenamename21_testhema", "parentCode": "ididid31112" }, { "departmentCode": "ididid311123", "name": "namenamename222test_hema", "parentCode": "ididid111123", "type": 2, "departmentId": 387 }, { "departmentCode": "ididid3", "name": "namenamename3", "parentCode": ”0“ } ] }'
2
3
4
操作成功
{ "code": 0, "msg": "success", }
操作失败
{ "code": -1, "msg": "false", }