Raiden/雷电API手册

查询指定代币的未结算对手方 - GET /api/(version)/tokens/(token_address)/partners

返回指定代币的所有包含未结算通道的对手方列表。

API请求

GET /api/(version)/tokens/(token_address)/partners

URL参数:

  • version:API版本号,目前可用:v1
  • token_address:代币地址

API响应

返回一个JSON数组,每个成员对象包含如下字段:

  • partner_address:对手方地址
  • channel:通道url

http响应的状态代码可能为以下值:

  • 200 OK – 查询成功
  • 302 Found – 如果用户访问通道链接端结点
  • 404 Not Found – 未找到
    • 指定的代币不存在
    • 指定的代币地址不是有效的EIP55编码以太坊地址
  • 500 Internal Server Error – Raiden节点内部错误

示例代码

curl请求示例:

curl -i http://localhost:5001/api/v1/tokens/0x61bB630D3B2e8eda0FC1d50F9f958eC02e3969F6/partners

响应结果如下:

HTTP/1.1 200 OK
Content-Type: application/json

[
   {
       "partner_address": "0x2a65aca4d5fc5b5c859090a6c34d164135398226",
       "channel": "/api/<version>/channels/0x61C808D82A3Ac53231750daDc13c777b59310bD9/0x2a65aca4d5fc5b5c859090a6c34d164135398226"
   }
]