queryRateHistory需要签名验签

2024-11-29 08:13

POST /amsin/api/v1/business/fund/queryRateHistory

集成商可高并发调用此接口查询特定时间段内的历史外汇牌价，以作参考。

报文结构

万里汇接口报文结构包括：请求头，请求体。关于头信息，详见：

入参

customerId String REQUIRED

由万里汇定义、用于唯一标识某万里汇账户。

更多信息：

最大长度：64 字符

startTime Long REQUIRED

查询历史汇率的开始时间。

此字段的格式为13位时间戳，示例：1659430628390

startTime 和 endTime 计算的历史汇率时长不得超过30天。

endTime Long REQUIRED

查询历史汇率的结束时间。

此字段的格式为13位时间戳，示例：1659430628390

startTime 和 endTime 计算的历史汇率时长不得超过30天。

sellCurrency String REQUIRED

符合ISO-4217规范的三字母货币代码，代表集成商卖出币种。

更多信息：

最大长度：3 字符

buyCurrency String REQUIRED

符合ISO-4217规范的三字母货币代码，代表集成商买入币种。

更多信息：

最大长度：3 字符

出参

result Result REQUIRED

代表API接口的调用结果。

Show child parameters

sellCurrency String REQUIRED

符合ISO-4217规范的三字母货币代码，代表集成商卖出的币种。

该字段只有当result.resultStatus = S时才会按需返回。

更多信息：

最大长度：3 字符

buyCurrency String REQUIRED

符合ISO-4217规范的三字母货币代码，代表集成商买入的币种。

该字段只有当result.resultStatus = S时才会按需返回。

更多信息：

最大长度：3 字符

currentRate RateDetails

historicalRates Array<RateDetails>

整点历史汇率列表。

该字段只有当result.resultStatus = S时才会按需返回。

Show child parameters

API Explorer

请求

URL

请求体

响应

响应体

响应处理

集成商调用接口后，万里汇返回集成商API调用结果。result.resultStatus 字段取值范围为：

result.resultCode：系统结果码

结果码	值	结果码信息	行动建议
SUCCESS	S	Success
PARAM_ILLEGAL	F	Illegal parameters exist. For example, a non-numeric input, or an invalid date.	参考API文档页面，确认请求头和传参是否正确。
PROCESS_FAIL	F	A general business failure occurred. Do not retry.	需要人工介入，联系万里汇技术支持以解决此问题。
UNKNOWN_EXCEPTION	U	API failed due to unknown reason.	服务器错误，若稍后重试问题依旧，联系万里汇技术支持以解决问题。
REQUEST_TRAFFIC_EXCEED_LIMIT	U	The request traffic exceeds the limit.	重试，若问题依旧，联系万里汇技术支持
OAUTH_FAIL	F	OAuth process failed.	联系万里汇技术支持了解详情。
INVALID_API	F	The called API is invalid or not active.	确认是否调用正确的API。
INVALID_CLIENT	F	The client is invalid.	Client ID不存在或无效。
INVALID_SIGNATURE	F	The signature is invalid.	确认请求正确加签，具体参见：请求头签名部分生成签名
METHOD_NOT_SUPPORTED	F	The server does not implement the requested HTTP method.	确认HTTP请求方法为`POST`

result.resultCode：业务结果码

结果码	值	结果码信息	行动建议
CONTRACT_CHECK_FAIL	F	The contract check failed.	联系万里汇技术支持了解合约状态后重试。
SYSTEM_ERROR	F	System error.	请勿重试，联系万里汇技术支持了解详情。
USER_NOT_EXIST	F	The user does not exist.	使用正确的用户信息重试。
AUTHORIZATION_NOT_EXIST	F	The authorization does not exist.	当前授权关系不存在，请联系万里汇技术支持检查授权关系。
CURRENCY_NOT_SUPPORT	F	The currency is not supported.	暂不支持该币种。

result.resultStatus	描述
S	API请求成功。
F	API请求失败。失败原因参见结果码（即 result.resultCode 和 result.resultMessage）
U	API响应结果为`UNKNOWN`（未知）时，需重试API请求。重试策略：重试次数上限：7次重试时间间隔：5分钟、10分钟、20分钟、40分钟、80分钟、160分钟、320分钟如果问题依旧，请联系万里汇技术支持。