批量同步接口
- 接口:common/levels/batch
- Method:POST
- 数据格式:JSON
- 限流信息:10次每天和5次每小时
- 多语言环境:在接口请求头中添加Key为locale,Value值为语言环境,目前支持的语言有zh_CN(中文)、en_US(英文)、ja_JP(日文)、zh_TW(繁体),请选取其中一种
- 接口说明:该接口用作职级的批量同步,在整批数据中如果只有几条数据因为其他原因失败,那么只有这几条数据不会被处理,其他数据仍会被正常处理
- 其他补充信息:单次数据量过大时候(超过200条)会全部转为异步处理,具体参考回调示例
参数:
请求参数
字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度限制(字节) |
bizId |
String |
当前次接口同步的唯一标识 |
TRUE |
36 |
timestamp |
long |
当前次接口同步对应的时间戳 |
TRUE |
13 |
data |
Array |
当前接口同步的数据集合 |
TRUE |
无 |
data.code |
String |
职级编码 |
TRUE |
64 |
data.enabled_flag |
String |
启用标志(Y/N,默认为Y) |
FALSE |
1 |
data.description |
String |
描述 |
FALSE |
255 |
返回参数
字段名称 |
字段类型 |
字段描述 |
bizId |
String |
当前次接口同步的唯一标识 |
resCode |
Integer |
响应状态码(见附录) |
resMsg |
String |
返回信息描述 |
created |
String |
创建成功的条数 |
updated |
String |
更新成功的条数 |
validatorErrors |
Array |
字段强校验不合格的数据 |
dbErrors |
Array |
数据持久化时出现错误的数据 |
warnings |
Array |
字段弱校验不合格的数据,任会做同步处理 |
示例:
请求数据
{
"bizId":"82915e6a-80fc-4c03-b0db-8c8ff2c731f4",
"timestamp":1591267905457,
"data":[
{
"description":"职级测试",
"code":"test-A315",
"enabled_flag":"N"
},
{
"description":"职级校验",
"code":"c2",
"enabled_flag":"M"
},
{
"description":"测试更新",
"code":"test-level",
"enabled_flag":"Y"
},
{
"description":"测试更新",
"code":"level5",
"enabled_flag":"Y"
}
]
}
返回数据
{
"resCode":200000,
"resMsg":"success",
"bizId":"82915e6a-80fc-4c03-b0db-8c8ff2c731f4",
"data":{
"validatorErrors":[
{
"code":"c2",
"messages":[
"请输入Y/N或者使用默认值"
]
}
],
"created":"此次请求新建成功了1条数据",
"warnings":[
],
"dbErrors":[
],
"updated":"此次请求更新成功了2条数据"
}
}