批量同步接口
- 接口：common/userCard/batch
- Method：POST
- 数据格式：JSON
- 限流信息：150次每天和50次每小时
- 多语言环境：在接口请求头中添加Key为locale,Value值为语言环境,目前支持的语言有zh_CN(中文)、en_US(英文)、ja_JP(日文)、zh_TW(繁体),请选取其中一种
- 接口说明：该接口用作人员证件信息的批量同步(user_name或employee_number为判断条件,二者必填其一,两者都填则以user_name为判断条件)，在整批数据中如果只有几条数据因为其他原因失败，那么只有这几条数据不会被处理，其他数据仍会被正常处理
- 其他补充信息：
参数:
请求参数
| 字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度限制(字节) |
| bizId |
String |
当前次接口同步的唯一标识 |
TRUE |
36 |
| timestamp |
long |
当前次接口同步对应的时间戳 |
TRUE |
13 |
| data |
Array |
当前次接口同步的数据集合 |
TRUE |
无 |
| data.user_name |
String |
用户名 |
FALSE |
64 |
| data.employee_number |
String |
员工号 |
FALSE |
64 |
| data.card_type |
String |
证件类型(1:身份证 2:护照 3:台胞证 4:港澳通行证) |
TRUE |
64 |
| data.card_no |
String |
证件号码 |
TRUE |
64 |
| data.time_limit |
String |
证件过期时间(格式 yyy-MM-dd) |
FALSE |
0 |
| data.enabled_flag |
String |
是否启用标志(Y/N,默认为Y) |
FALSE |
1 |
| data.primary_flag |
String |
默认类型标识(Y/N) |
FALSE |
1 |
返回参数
| 字段名称 |
字段类型 |
字段描述 |
| bizId |
String |
当前次接口同步的唯一标识 |
| resCode |
Integer |
响应状态码（见附录） |
| resMsg |
String |
返回信息描述 |
| created |
String |
创建成功的条数 |
| updated |
String |
更新成功的条数 |
| validatorErrors |
Array |
字段强校验不合格的数据 |
| dbErrors |
Array |
数据持久化时出现错误的数据 |
| warnings |
Array |
字段弱校验不合格的数据，任会做同步处理 |
示例：
请求数据
{
"bizId": "293847928374893274",
"timestamp": 942085094850934,
"data": [
{
"user_name": "libo.yang@cloudpense.com",
"card_type": "3",
"card_no": "330230980934sslssllslllslll3",
"primary_flag": "Y",
"time_limit": "2403-11-11"
},
{
"card_type": "1",
"card_no": "330304200405102222",
"primary_flag": "Y",
"time_limit": "2403-11-11"
}
]
}
返回数据
{
"resCode": 200,
"resMsg": "SUCCESS",
"bizId": "293847928374893274",
"data": {
"validatorErrors": {
"没有EmployNumber和UserName的数据": "有1条"
},
"created": "此次请求新建成功了0条数据",
"dbErrors": [],
"updated": "此次请求更新成功了1条数据"
}
}