查询指定代币的未结算对手方 - 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"
}
]