Raiden/雷电API手册

查询支付历史 - 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"
    }
]