2.1 部门同步(主动查询)
# 2.1 部门同步(主动查询)
企业方面提供查询接口,百福得主动查询,全量更新部门信息(分页查询)
# 接口URL
客户方提供,百福得主动查询
# HTTP请求方式
POST
# 公共参数
| 字段 | 类型 | 是否必填 | 中文意描述 |
|---|---|---|---|
| appId | String | 是 | appId,由客户方提供 |
| timestamp | String | 是 | 毫秒级时间戳 防止重复攻击 |
| version | String | 否 | 业务接口版本号,如1.0.0 |
| sign | String | 是 | 签名 |
# body参数
| 字段 | 类型 | 是否必填 | 中文意描述 |
|---|---|---|---|
| pageNo | Integer | 是 | 页码 |
| pageSize | Integer | 是 | 单页数量 默认200 |
# 请求示例
POST /deplist?appId=abc×tamp=1620710648458&sign=fa66cb4d8604413b8fb30afd32e3e73e HTTP/1.1 Content-Type: application/json Cache-Control: no-cache { "pageNo":1, "pageSize":200 }1
2
3
4
5
6
7
# 返回参数说明
| 字段 | 类型 | 是否必填 | 中文意描述 |
|---|---|---|---|
| code | String | 返回码 | |
| data | ResponseData | 否 | 部门列表 |
| msg | String | 否 | 如果错误,返回错误信息 |
ResponseData:
| 字段 | 类型 | 是否必填 | 中文意描述 |
|---|---|---|---|
| name | String | 是 | 部门名称 |
| code | String | 是 | 部门编码(唯一) |
| parentCode | String | 否 | 父级部门编码(无则为顶级部门) |
# 返回示例
success:
{
"code": "0",
"msg": "success",
"data": [
{
"name": "技术部",
"code": "TL001",
"parentCode": "001"
},
{
"name": "财务中心",
"code": "CA002",
"parentCode": "001"
}
]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
fail:
{
"code": "10016",
"data": null,
"msg": "签名错误"
}
1
2
3
4
5
2
3
4
5