组织架构全量同步
最后更新于 2024/11/06 阅读数 32
Moka 系统中会根据请求的列表对当前系统中的部门进行同步（新增，更新，标记删除）。
同步以department_code为主键，与系统中部门department_code进行对比：
1、当前系统没有，同步时有：新增一个部门
2、当前系统有，同步时也有：更新已经存在的部门信息。如果同步时有，当前系统部门状态标识为删除，更新后，状态改为正常。
3、当前系统有，同步时没有时：部门打标已删除，需要手动进入 Moka 系统中将该部门合并到其他部门进行删除。
HTTP 请求
PUT 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[].sequence | 否 | number | 指定部门排序，支持0至10000的两位小数，为空默认排在最后。按排序从小到大，创建时间从先到后排序 |
返回json字段
字段 | 类型 | 描述 |
|---|---|---|
code | number |
|
msg | string | 操作失败的错误原因 |
可能的错误信息
errorMessage | 描述 |
|---|---|
部门 ID 重复 | 请求列表中有重复使用的 department_code |
部门重复 | 请求列表中有相同父级部门，名称的部门 |
父级部门未找到 | 部门的父级部门未在列表中找到 |
部门的父级部门不能直接(间接)为自身 | 部门的父级部门（的父级部门...)不能为自身 |
... |
请求样例
$ curl 'https://api.mokahr.com/api-platform/v2/departments' \
-u 'your_api-keys:' \
-X PUT \
-d '{ "departments": [ { "departmentCode": "ididid1", "name": "namenamename1", "parentCode": "ididid1", "sequence": 0 }, { "departmentCode": "ididid2", "name": "namenamename2", "parentCode": "ididid2" }, { "departmentCode": "ididid2", "name": "namenamename2", "parentCode": "ididid2", "type": 2 }, { "departmentCode": "ididid3", "name": "namenamename3", "parentCode": ”0“} ] }'
1
2
3
4
plaintext2
3
4
操作成功
{ "code": 0, "msg": "success", "data":{ "result": { "new": 0, "delete": 0, "update": 0 } } }
1
plaintext操作失败
{ "code": -1, "msg": "false", }
1
plaintext
评价这篇文档
有帮助
没帮助
未能解决您的问题？请联系
在线客服
