2.2 部门同步（客户推送）

百福得提供接口，企业实时/定时同步部门数据到百福得，若部门已存在，则忽略

接口URL

{开放平台域名地址}/openApi/open/department/v1/push

HTTP请求方式

POST

公共参数

字段	类型	是否必填	中文意描述
appId	String	是	由百福得向客户方发放
timestamp	String	是	毫秒级时间戳 防止重复攻击
sign	String	是	签名
version	String	否	业务接口版本号，如1.0.0

body参数

字段	类型	最大长度	是否必填	中文意描述
name	String	250	是	部门名称
code	String	64	是	部门编码（唯一）
parentCode	String	64	否	父级部门编码（无则为顶级部门）
status	Integer	10	是	增量同步状态：1：新增或更新 2：删除
sort	Integer	10	否	排序

请求示例

POST /openApi/open/department/v1/push?appId=abc&timestamp=1597300776947&sign=fa66cb4d8604413b8fb30afd32e3e73e HTTP/1.1
Content-Type: application/json
Cache-Control: no-cache
[
{
 "status": 1,
 "name": "技术部",
 "code": "TL001",
 "parentCode": "001",
 "sort": 1
 },
{
"status": 1,
 "name": "财务中心",
 "code": "CA002",
 "parentCode": "001",
 "sort": 2
 }
 ]

返回参数说明

字段	类型	是否必填	中文意描述
code	String	返回码
msg	String	否	如果错误，返回错误信息

返回示例

success:

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

fail:

{
  "code": "10016",
  "msg": "签名错误"
}