查询支付历史 - GET /api/v1/payments/(token_address)/(target_address)
查询支付历史,包括支付发送成功(EventPaymentSentSuccess)和 支付发送失败(EventPaymentSentFailed)以及支付接收成功(EventPaymentReceivedSuccess)。
API请求
GET /api/v1/payments/(token_address)/(target_address)
URL参数:
- version:API版本号,目前可用:v1
- token_address:代币地址,可选
- target_address:对方地址,可选
BODY参数对象,主要包含以下字段:
- amount:要发送给对方的数量,整数
- identifier:本次支付的标识符,整数,可选
API响应
返回一个JSON数组,每个成员对象包含如下字段:
- event:事件名称
- amount:支付金额
- initiator:支付发起地址
- identifier:支付交易标识符
- log_time:日志时间
注册代币API的http响应代码可能为以下值:
- 200 OK – 查询成功
- 404 Not Found – 指定的代币或对方地址不是有效的EIP55以太坊地址
- 409 Conflict – 指定的区块号或代币地址参数无效
- 500 Internal Server Error – Raiden节点内部错误
示例代码
curl请求示例:
curl -i http://localhost:5001/api/v1/payments/0x0f114A1E9Db192502E7856309cc899952b3db1ED/0x82641569b2062B545431cF6D7F0A418582865ba7
响应结果如下:
HTTP/1.1 200 OK
Content-Type: application/json
[
{
"event": "EventPaymentReceivedSuccess",
"amount": 5,
"initiator": "0x82641569b2062B545431cF6D7F0A418582865ba7",
"identifier": 1,
"log_time": "2018-10-30T07:03:52.193"
},
{
"event": "EventPaymentSentSuccess",
"amount": 35,
"target": "0x82641569b2062B545431cF6D7F0A418582865ba7",
"identifier": 2,
"log_time": "2018-10-30T07:04:22.293"
},
{
"event": "EventPaymentSentSuccess",
"amount": 20,
"target": "0x82641569b2062B545431cF6D7F0A418582865ba7"
"identifier": 3,
"log_time": "2018-10-30T07:10:13.122"
}
]