同步部门

简介

同步部门，支持新增、更新及删除，更新时需携带新增时返回的唯一标识

服务提供方

享道

接口URL

/openapi/ent/dept/add

请求方式

POST

请求频次

单次

请求参数

参数名称	类型	必选	说明
timestamp	long	是	请求时间，Unix Timestamp单位毫秒
ent_id	string	是	企业唯一标识
departments	List	是	部门信息
departments[].dept_id	string	是	部门唯一标识，更新时必传
departments[].parent_dept_id	string	是	上级部门唯一标识，更新时必传
departments[].dept_name	string	是	部门名称
departments[].leader_id	string	是	部门负责人唯一标识，来自员工同步接口
departments[].outer_dept_id	string	是	外部部门唯一标识
departments[].outer_parent_dept_id	string	是	外部部门唯一标识，有上级部门必传
departments[].is_del	string	是	是否删除 0-否 1-是

响应参数

参数名称	类型	必有	说明
retCode	int	是	服务响应状态，参见附录5
retMsg	string	是	服务响应状态说明，参见附录5
content	object	是	响应内容
content.results	list	是	所有同步结果
content.results[].success	boolean	是	是否成功
content.results[].fail_msg	string	是	失败原因
content.results[].dept_id	string	是	部门唯一标识
content.results[].outer_dept_id	string	是	外部部门唯一标识

请求事例

请求

curl --location --request POST 'https://xxx/v1/openapi/ent/dept/add' \
--header 'X-Sign: 5e9745dea27fc8b7b4b90aa2565868c0ebf847fd' \
--header 'X-SignAlgorithm: 1' \
--header 'X-Timestamp: 20201020164300' \
--header 'X-MerchantId: open_xxx' \
--header 'Content-Type: application/json' \
--data-raw '{"timestamp":20201020164300,"ent_id":"ent_xxx","departments":[{"dept_name":"无上级部门","leader_id":"110","outer_dept_id":"1231244","is_del":"0"},{"dept_name":"有上级部门","leader_id":"1101","outer_dept_id":"1231245","out_parent_dept_id":"123123","is_del":"0"}]}'

响应

{
  "errCode": 10000,
  "errMsg": "successful",
  "content": {
    "results": [
        {
          "success": true,
          "dept_id": "xxx",
          "outer_dept_id": "xxx"
        }
    ]
  }
}