提供部门增加删除标识(已删除部门不合并到另一个部门)和删除部门(删除部门并将已删除部门合并到其他部门
1、部门改为删除状态:如果不传target_department_code,则该部门仅标记为“已删除”状态,实际上还需要在系统内操作删除;
2、删除部门:如果传入target_department_code,则部门数据被合并至target_department_code对应的部门,原部门数据被删除。
HTTP请求
DELETE https://api.mokahr.com/api-platform/v1/departments
请求body参数
字段 | 必填 | 类型 | 描述 |
---|---|---|---|
departments[] | 是 | array | 部门的信息 |
departments[].department_code | 是 | string | 客户系统的部门id |
departments[].target_department_code | 否 | string | 目标部门的唯一编号 |
是 | string | 已经在moka系统中注册过的邮箱 |
返回json字段
字段 | 类型 | 描述 |
---|---|---|
success | boolean | 操作是否成功 |
errorMessage | string | 操作失败的错误原因 |
可能的错误信息
errorMessage | 描述 |
---|---|
当前有未处理完的组织架构更新,请稍后再试 | |
父级部门未找到 | 删除或者合并部门之后某部门的父级部门未找到 |
部门的父级部门不能直接(间接)为自身 | 删除之后部门的父级部门(的父级部门...)不能为自身 |
部门名称XXX,父编号XXX的部门名称已存在 | 某部门下存在相同名称的部门 |
系统中不存在email为XXX的用户 | 无 |
department_code: XXX 在系统中不存在 | 无 |
请求样例
curl 'https://api.mokahr.com/api-platform/v1/departments' \
-u 'your_api_keys' \
-X DELETE \
-d ' { "departments": [ { "department_code": "EN0100321", "target_department_code": "EN0100322" }, { "department_code": "EN0100323" } ], "email": "test@test.com" }'
2
3
4
操作成功
{ "code": 0, "msg": "成功", "success": true, "errorMessage": "", "data": {} }
操作失败
{ "code": 625011, "msg": "department_code(3213232888)在系统中已存在", "success": false, "errorMessage": "department_code(323232888)在系统中已存在", "data": {} }