批量同步接口
- 接口：common/fxrates/v2/batch
- Method：POST
- 数据格式：JSON
- 限流信息：50次每天
- 多语言环境：在接口请求头中添加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 |
编码(默认传1) |
TRUE |
64 |
| data.from_currency |
String |
原始币种 |
TRUE |
64 |
| data.to_currency |
String |
折算币种 |
TRUE |
64 |
| data.exchange_date |
String |
汇率时间(格式yyyy-MM-dd) |
TRUE |
11 |
| data.exchange_rate |
BigDecimal |
外汇汇率 |
TRUE |
65 |
| data.source |
String |
汇率来源 |
TRUE |
64 |
| data.category |
String |
汇率类型代码 |
FALSE |
64 |
返回参数
| 字段名称 |
字段类型 |
字段描述 |
| bizId |
String |
当前次接口同步的唯一标识 |
| resCode |
Integer |
响应状态码（见附录） |
| resMsg |
String |
返回信息描述 |
| created |
String |
创建成功的条数 |
| updated |
String |
更新成功的条数 |
| validatorErrors |
Array |
字段强校验不合格的数据 |
| dbErrors |
Array |
数据持久化时出现错误的数据 |
| warnings |
Array |
字段弱校验不合格的数据，任会做同步处理 |
示例：
请求数据
{
"bizId": "53e6cc08-dfe3-4351-9dda-257c22a5f4f5",
"timestamp": 1599214539593,
"data": [
{
"code": "1",
"from_currency": "CES",
"to_currency": "UAD",
"exchange_date": "2020-09-04",
"exchange_rate": 190.5100000001,
"category": "1211"
},
{
"code": "1",
"from_currency": "CES",
"to_currency": "CNY",
"exchange_date": "2020-09-05",
"exchange_rate": 488.7900000001
},
{
"code": "1",
"from_currency": "UUD",
"to_currency": "CNY",
"exchange_date": "2020-09-01",
"exchange_rate": 129.650000001
},
{
"code": "1",
"from_currency": "UUD",
"to_currency": "CNY",
"exchange_date": "2020-09-02",
"exchange_rate": 514.6100000001
},
{
"code": "1",
"from_currency": "UYD",
"to_currency": "CNY",
"exchange_date": "2020-09-02",
"exchange_rate": 514.6100000002
}
]
}
返回数据
{
"resCode" : 200000,
"resMsg" : "success",
"bizId" : "53e6cc08-dfe3-4351-9dda-257c22a5f4f5",
"data" : {
"validatorErrors" : [ ],
"created" : "此次请求新建成功了2条数据",
"warnings" : [ ],
"dbErrors" : [ ],
"updated" : "此次请求更新成功了3条数据"
}
}