HTTP请求

POST https://api.mokahr.com/api-platform/v2/departments/sync/incremental

请求body参数

字段	必填	类型	描述
departments	是	array	部门数据
departments[].name	是	string	部门名称
departments[].departmentCode	是	string	客户系统的部门id
departments[].parentCode	是	string	部门的上级部门的唯一 id,如为一级部门传“0”
departments[].type	否	number	部门类型: `1` ：普通部门（默认） `2` ：门店部门
departments[].sequence	否	number	指定部门排序，支持0至10000的两位小数，为空默认排在最后。按排序从小到大，创建时间从先到后排序

返回字段

字段	类型	描述
code	number	200: 成功。其他：错误
msg	string	操作失败的错误原因

可能的错误信息

errorMessage	描述
当前有未处理完的组织架构更新，请稍后再试
部门名称: XXX, 编号XXX的部门编号重复	请求列表中存在重复部门数据或者请求列表中存在于已同步至系统的部门中存在重复
父级部门未找到	部门的父级部门未在列表中找到
部门的父级部门不能直接(间接)为自身	部门的父级部门（的父级部门...)不能为自身
部门名称XXX，父编号XXX的部门名称已存在	某部门下存在相同名称的部门
...

请求样例

$ curl 'https://api.mokahr.com/api-platform/v2/departments/sync/incremental' \
   -u 'your_api-keys:' \
   -X POST \
   -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

plaintext

操作成功

{ "code": 0, "msg": "success", }

plaintext

操作失败

{ "code": -1, "msg": "false", }

plaintext

组织架构全量同步

更新组织架构

评价这篇文档

有帮助

没帮助

未能解决您的问题？请联系

在线客服

本篇目录

HTTP请求

请求body参数

返回字段

可能的错误信息

请求样例

操作成功

操作失败