批量同步接口
- 接口:/common/absenceAccountQuota/batch
- Method:POST
- 数据格式:JSON
- 限流信息:150次每天和50次每小时
- 多语言环境:在接口请求头中添加Key为locale,Value值为语言环境,目前支持的语言有zh_CN(中文)、en_US(英文)、ja_JP(日文)、zh_TW(
繁体),请选取其中一种
- 接口说明:该接口用作假期额度信息的批量同步(根据code是否存在判断新增/更新)
,在整批数据中如果只有几条数据因为其他原因失败,那么只有这几条数据不会被处理,其他数据仍会被正常处理
- 其他补充信息:该接口用作假期额度信息的批量同步(根据code是否存在判断新增/更新)
,在整批数据中如果只有几条数据因为其他原因失败,那么只有这几条数据不会被处理,其他数据仍会被正常处理
参数:
请求参数
| 字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度限制(字节) |
| bizId |
String |
当前次接口同步的唯一标识 |
TRUE |
36 |
| timestamp |
long |
当前次接口同步对应的时间戳 |
TRUE |
13 |
| data |
Array |
当前次接口同步的数据集合 |
TRUE |
无 |
| data.code |
String |
假期额度的唯一凭证,需确保全局唯一,更新数据时以此字段为依据 |
TRUE |
64 |
| data.user_name |
String |
用户名,可查询到唯一用户的值 |
TRUE |
64 |
| data.start_datetime |
long |
开始日期,0时区时间戳,精确到天 |
TRUE |
无 |
| data.end_datetime |
long |
结束日期,0时区时间戳,精确到天 |
TRUE |
无 |
| data.absence_code |
String |
假期类型代码 |
TRUE |
100 |
| data.absence_account_code |
String |
假期额度类型代码 |
TRUE |
100 |
| data.absence_unit |
String |
请假单位 |
TRUE |
10 |
| data.total |
BigDecimal |
额度 |
TRUE |
无 |
| data.used |
BigDecimal |
已使用,新增时不必填,更新时必填 |
FALSE |
系统自动计算 |
返回参数
| 字段名称 |
字段类型 |
字段描述 |
| bizId |
String |
当前次接口同步的唯一标识 |
| resCode |
Integer |
响应状态码(见附录) |
| resMsg |
String |
返回信息描述 |
| created |
String |
创建成功的条数 |
| updated |
String |
更新成功的条数 |
| validatorErrors |
Array |
字段强校验不合格的数据 |
| dbErrors |
Array |
数据持久化时出现错误的数据 |
| warnings |
Array |
字段弱校验不合格的数据,任会做同步处理 |
示例:
请求数据
{
"bizId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": 1691395752072,
"data": [
{
"code": "550e8400-e29b-41d4-a716-446655441234",
"user_name": "test@cloudpense.com",
"start_datetime": 1735689600000,
"end_datetime": 1767139200000,
"absence_code": "劳务公司年假001",
"absence_account_code": "劳务公司法定年假001",
"absence_unit": "day",
"total": "5"
}
]
}
返回数据
{
"resCode": 200000,
"resMsg": "success",
"bizId": "d162175f-5bdf-43c8-a245-a013dc219ffd",
"data": {
"validatorErrors": [],
"created": "此次请求新建成功了0条数据",
"warnings": [],
"dbErrors": [],
"updated": "此次请求更新成功了1条数据"
}
}