Moka 系统中会根据请求的列表对当前系统中的> 职责进行同步(新增,更新,标记删除)。每次最多同步200条。 同步以positionCode为主键,与系统中部门positionCode进行对比: 1、当前系统没有,同步时有:新增一个> 职责 2、当前系统有,同步时也有:更新已经存在的> 职责信息。如果同步时有,当前系统> 职责状态标识为删除,更新后,状态改为正常。 3、当前系统有,同步时没有时:部门打标已删除,需要手动进入 Moka 系统中将该部门合并到其他部门进行删除。
HTTP 请求
POST https://api.mokahr.com/api-platform/v1/positions/syncInfo
请求body参数
字段 | 必填 | 类型 | 描述 |
---|---|---|---|
data | 是 | array | > 职责数组 |
data[].name | 是 | string | > 职责名称 |
data[].positionCode | 是 | string | > 职责编码,> 职责唯一识别码,用于组织架构同步时,传入关联> 职责。 |
data[].enable | 是 | boolean | > 职责是否启用 |
data[].departmentCodes | 否 | array | 关联部门code列表,选填,在组织架构中进行关联。匹配优先级低于departmentIds |
data[].departmentIds | 否 | array | 关联部门id列表,选填,在组织架构中进行关联;可以通过“获取全量组织架构”接口进行查询。匹配优先级大于departmentCodes |
data[].allDepartments | 否 | boolean | > 职责是否关联全部部门 |
返回字段
字段 | 类型 | 描述 |
---|---|---|
code | number | 返回的code: |
msg | string | 返回状态说明 |
data | array | 返回的数据 |
data[].addCount | number | 新增> 职责数量 |
data[].updateCount | number | 更新> 职责数量 |
data[].errorList | array | 同步失败的数据 |
data[].errorList[].positionCode | string | 同步失败的> 职责编码 |
data[].errorList[].name | string | 同步失败的> 职责名称 |
data[].errorList[].msg | string | 该> 职责同步失败的原因 |
请求样例
$ curl 'https://api.mokahr.com/api-platform/v1/positions/syncInfo' \
-u 'your_api_key:' \
-X POST \
-d '{ data: [ { "name": "1234", "positionCode": "s1234567890123456789012345678901234567890123456789", "enable": true, "departmentCodes":[411,"dd"], "departmentIds": [411], "allDepartments": true }, { "name": "1234567", "positionCode": "s111", "enable": true, "departmentCodes":[411,"dd"], "departmentIds":[411], "allDepartments": false } ] }'
2
3
4
操作结果
{ "code": 200, "msg": "success", "data": { "addCount": 0, "errorList": [ { "code": { "explain": "> 职责名称已存在", "name": "626005" }, "data": { "allDepartments": true, "departmentCodes": [ "411", "dd" ], "departmentIds": [ 411 ], "enable": true, "name": "1234", "positionCode": "s1234567890123456789012345678901234567890123456789" } }, { "code": { "explain": "> 职责名称已存在", "name": "626005" }, "data": { "allDepartments": false, "departmentCodes": [ "411", "dd" ], "departmentIds": [ 411 ], "enable": true, "name": "1234567", "positionCode": "s111" } } ], "updateCount": 0 } }