分页拉取指定资产已授予碎片列表
更新时间：2022-08-12
分页拉取指定资产已授予碎片列表
接口描述
- 本接口用于分页拉取指定资产已授予的碎片列表
请求结构
JSON
1POST /xasset/horae/v1/listsdsbyast HTTP/1.1
2Host: xuper.baidu.com
3Authorization: Authorization string
4Content-Type: application/x-www-form-urlencoded;charset=utf-8
5
6asset_id={asset_id}
7&cursor={cursor}
8&limit={limit}请求头域
- 除公共头域外，无其它特殊头域。
请求参数
| 参数名 | 参数类型 | 是否可选 | 参数说明 |
|---|---|---|---|
| asset_id | string | 必选 | 要查询的资产id |
| cursor | string | 必选 | 分页游标，首页设置空字符串，后面的用上页返回的cursor值 |
| limit | int | 可选 | 默认20，最大50 |
响应头域
- 除公共头域外，无其它特殊头域。
响应参数
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| errmsg | string | 错误信息 |
| errno | int | 错误码 详情参考错误码和状态码 |
| request_id | int | 后端生成，用于问题反馈，建议业务日志纪录 |
| cursor | string | 分页游标 |
| has_more | int | 0:已拉取完成 1:还有剩余数据 |
| list | array | 资产信息 |
| +asset_id | int64 | 资产id |
| +shard_id | int64 | 资产碎片id |
| +owner_addr | string | 持有资产账户地址 |
| +price | int64 | 资产显示价格，单位为分 |
| +tx_id | string | 上链交易tx_id，以上链后才会设置 |
| +ctime | int | 登记时间 |
请求示例
JSON
1Post /xasset/horae/v1/listsdsbyast
2Host: xuper.baidu.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2022-04-18T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4
5addr=uoiu789nknmsfsfds
6&cursor=
7&limit=20响应示例
JSON
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3Date: Wed, 18 Apr 2022 03:28:11 GMT
4X-Trace-Id: "1182282645"
5 {
6 {
7 "errmsg": "succ",
8 "errno": 0，
9 "request_id": "916556533358021977",
10 "cursor": "xxxxxx",
11 "has_more": 1, // 0:已拉取完成 1:还有剩余数据
12 "list": [
13 {
14 "asset_id": 12345,
15 "shard_id": 123343,
16 "price": 1000,
17 "tx_id": "23857a8dabf6b749a3xxxx742a90877b630eaa56",
18 "owner_addr": "xxxxxxxx",
19 "ctime": 123
20 }，
21 {
22 "asset_id": 12345,
23 "shard_id": 123343,
24 "price": 1000,
25 "tx_id": "23857a8dabf6b749a3xxxx742a90877b630eaa56",
26 "owner_addr": "xxxxxxxx",
27 "ctime": 123
28 }
29 ]
30}
31}