组织架构全量同步

PUT

/api-platform/v2/departments

处理

Moka 系统中会根据请求的列表对当前系统中的部门进行同步（新增，更新，标记删除）。

可能的错误信息

errorMessage	描述
部门 ID 重复	请求列表中有重复使用的 department_code
部门重复	请求列表中有相同父级部门，名称的部门
父级部门未找到	部门的父级部门未在列表中找到
部门的父级部门不能直接(间接)为自身	部门的父级部门（的父级部门...)不能为自身
...

注意事项

调试请先联系相关负责人开启。如果请求中曾经有，现在没有了的部门将被标记为已删除状态。位于已删除状态需要手动进入 Moka 系统中将该部门合并到其他部门以完全删除。如果已删除状态的部门重新同步（departmentCode相同），则回取消原来的已删除状态（不会重新创建新的部门）。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://api.mokahr.com/api-platform/v2/departments' \
--header 'Content-Type: application/json' \
--data-raw '{
       "departments": [
        { "departmentCode": "ididid1", "name": "namenamename1", "parentCode": "ididid1" },
        { "departmentCode": "ididid2", "name": "namenamename2", "parentCode": "ididid2" },
        { "departmentCode": "ididid2", "name": "namenamename2", "parentCode": "ididid2", "type": 2 },
        { "departmentCode": "ididid3", "name": "namenamename3", "parentCode": null, "requiredFieldsValueIsNull": ["parentCode"] }
    ]
  }'

响应示例

200 - 成功 - 成功示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "result": {
            "new": 0,
            "delete": 0,
            "update": 0
        }
    }
}