新增/更新
- 接口:/exchangerate/save
- Method:POST
- 数据格式:JSON
请求参数
参数 | 类型 | 必须 | 默认值 | 主键 | 描述 |
---|---|---|---|---|---|
from | string | Y | Y | 源货币 | |
to | string | Y | Y | 目标货币 | |
rate | decimal | Y | 汇率 | ||
effectiveDate | long | N | now + 1 | 汇率生效起始时间,默认是系统收到请求时间+1天 | |
subsidiaryBizCode | string | N | 适用业务实体编码,默认是全集团可用 |
返回参数
字段 | 类型 | 描述 |
---|---|---|
code | string | 系统内唯一主键 |
from | string | 源货币 |
to | string | 目标货币 |
备注
- 原货币和目标货币为ISO国际标准支持的货币符号,比如CNY,USD等
- rate 限制精度6位
- 汇率不支持删除操作
- 提供新的汇率,老的汇率会在新的汇率启用时失效
- effectiveDate必须是当天0点0分0秒之后的时间戳,比如当前日期是2018-10-19 ,那么effectiveDate必须大于等于1539878400000
- effectiveDate以服务器时区当天00:00:00为生效起始时间,比如1467894006000,转换为服务器所在时区时间为2016-07-07 20:20:06,所以汇率生效起始时间为2016-07-07 00:00:00
- 如果更新数据的某条from、to、rate、effectiveDate、subsidiaryBizCode数值和数据库中数值完全相同,则对该条数据不进行更新
示例:
请求数据
{
"timestamp": 1467894006000,
"data": [{
"from": "USD",
"to": "CNY",
"rate": 6.123456,
"effectiveDate": 1467894006000,
"subsidiaryBizCode": "DAHUA"
}
]
}
返回数据(成功)
{
"code": "ACK",
"message": "",
"data": [{
"from": "USD",
"to": "CNY"
}
]
}
返回数据(失败)
{
"code": "NACK",
"message": "处理错误",
}
部分更新示例:
请求数据(第二条数据与数据库中一条完全相同)
{
"timestamp": 1467894006000,
"data": [{
"from": "CNY",
"to": "HKD",
"rate": 1.123450,
"effectiveDate": 1553184000000,
"subsidiaryBizCode": "SI001"
},{
"from": "CNY",
"to": "BGN",
"rate": 2.2211,
"effectiveDate": 1553184000000,
"subsidiaryBizCode": "SI001"
}
]
}
返回数据
{
"code": "ACK",
"message": "",
"data": [
{
"from": "CNY",
"to": "HKD"
}
]
}