汇率查询接口
业务说明
根据基准货币和兑换货币以及生效时间获取系统定义汇率和中行汇率
- 可以根据提供了基准货币和兑换货币以及生效时间能够查到定义汇率和中行汇率
- 根据基准货币和兑换货币以及生效时间未查到有效汇率，系统将基准货币和兑换货币反查询，得到定义汇率和中行汇率（例如系统中只维护了HKD->CNY汇率为0.8,如果我们查询CNY->HKD未能查到，会进行汇率1/rate转化）
注意事项
- 接口会返回最新一条生效时间早于等于查询条件effectiveDate的有效数据。比如查询条件effectiveDate为1688140800000（2023-07-01 00:00:00），若系统内有一条最近生效时间是20230630的最新数据，也会返回。
- 返参的失效时间参数有值的场景：比如查询条件effectiveDate为1688140800000（2023-07-01 00:00:00），系统内有一条自定义汇率生效日期为2023-07-03 00:00:00，还有一条自定义汇率生效日期早于effectiveDate值且失效日期晚于effectiveDate值，则会返回第二条数据，且返参的endAt等于该条的失效日期。
接口地址
/api/openapi/currency/sys-exchange-rate
请求方式
POST
请求参数
参数说明
| 参数名称 |
参数值 |
是否必须 |
默认值 |
备注 |
| from |
string |
Y |
|
基准货币，币种 |
| to |
string |
Y |
|
兑换货币，币种 |
| effectiveDate |
long |
Y |
|
生效时间-开始范围，毫秒的时间戳 |
参数示例
{
"data": {
"effectiveDate": 1689830100000,
"from": "EUR",
"to": "CNY"
}
}
响应参数
参数说明
| 名称 |
类型 |
是否必须 |
默认值 |
备注 |
其他信息 |
| code |
string |
Y |
|
返回ACK或NACK |
|
| message |
string |
N |
|
|
|
| data |
object[] |
Y |
|
汇率信息 |
|
| errorCode |
string |
Y |
|
错误标识 |
|
| success |
boolean |
N |
|
是否成功 |
data 参数说明
| 名称 |
类型 |
是否必须 |
默认值 |
备注 |
| fromCurrency |
string |
Y |
|
基准货币 |
| toCurrency |
string |
Y |
|
兑换货币 |
| exchangeRate |
number |
Y |
|
汇率 |
| rateType |
string |
Y |
|
汇率两种来源 SYSTEM：中行同步汇率 CUSTOM：系统自定义汇率 |
| startedAt |
long |
Y |
|
生效时间 |
| endAt |
long |
N |
|
失效时间 |
参数示例
{
"code": "ACK",
"message": "",
"data": [
{
"fromCurrency": "EUR",
"toCurrency": "CNY",
"exchangeRate": 8.051000,
"rateType": "CUSTOM",
"startedAt": 1689782400000,
"endAt": 1690214400000
},
{
"fromCurrency": "EUR",
"toCurrency": "CNY",
"exchangeRate": 8.055800,
"rateType": "SYSTEM",
"startedAt": 1689782414000,
"endAt": 0
}
],
"errorCode": null,
"success": true
}
异常结果
{
"code": "NACK",
"message": "基准货币和兑换货币不能为空",
"data": null,
"errorCode": null,
"success": false
}