组织架构增量同步
POST
/api-platform/v2/departments/sync/incremental可能的错误信息
errorMessage | 描述 |
---|---|
当前有未处理完的组织架构更新,请稍后再试 | |
部门名称: XXX, 编号XXX的部门编号重复 | 请求列表中存在重复部门数据或者请求列表中存在于已同步至系统的部门中存在重复 |
父级部门未找到 | 部门的父级部门未在列表中找到 |
部门的父级部门不能直接(间接)为自身 | 部门的父级部门(的父级部门...)不能为自身 |
部门名称XXX,父编号XXX的部门名称已存在 | 某部门下存在相同名称的部门 |
... |
PS:组织架构增量同步需要使用POST请求,如果使用PUT请求,会认为是全量同步,将不存在的部门标记为已删除。
请求参数
Body 参数application/json
departments
array [object {5}]
部门数据
departmentCode
string
部门的唯一 id
name
string
部门名称
parentCode
string | null
必需
部门的上级部门的唯一 id, 如为 null 则为一级部门
type
integer
可选
部门类型: 1 普通部门(默认) 2 门店部门
requiredFieldsValueIsNull
array[string]
可选
上级部门为null时,需要传该参数["parentCode"]
示例
{
"departments": [
{
"departmentCode": "string",
"name": "string",
"parentCode": "string",
"type": 0,
"requiredFieldsValueIsNull": [
"string"
]
}
]
}
示例代码
返回响应
成功(200)
失败(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
code
integer
操作失败的错误原因
msg
string
操作失败的错误原因
示例
{
"code": 0,
"msg": "success"
}
修改于 3 年前