分页拉取指定账户持有碎片列表
接口描述
- 本接口用于分页拉取指定账户持有碎片列表
- asset_id是可选参数,可以拉取指定账户持有指定藏品的碎片列表。
请求结构
POST /xasset/horae/v1/listsdsbyaddr HTTP/1.1
Host: https:
Authorization: Authorization string
Content-Type: application/x-www-form-urlencoded;charset=utf-8
addr={addr}
&page={page}
&limit={limit}
&asset_id={assetid}
请求头域
请求参数
参数名 |
参数类型 |
是否可选 |
参数说明 |
addr |
string |
必选 |
创建资产账户地址 |
page |
int |
必选 |
要拉取页数,第一页为1 |
limit |
int |
可选 |
默认20,最大50 |
asset_id |
int64 |
可选 |
拉取持有指定藏品的碎片列表 |
status |
int |
可选 |
拉取指定状态的碎片列表 |
响应头域
响应参数
参数名 |
参数类型 |
参数说明 |
errmsg |
string |
错误信息 |
errno |
int |
错误码 详情参考错误码和状态码 |
request_id |
int |
后端生成,用于问题反馈,建议业务日志纪录 |
total_cnt |
int |
总条目数 |
list |
array |
资产信息列表 |
+asset_id |
int64 |
资产id |
+shard_id |
int64 |
资产碎片id |
+owner_addr |
string |
持有资产账户地址 |
+uid |
int |
业务传递的关联id,必要时由业务做机密混淆处理 |
+price |
int64 |
资产显示价格,单位为分 |
+status |
int |
0:已上链 1:授予中 4:转移中 5: 核销中 6: 已核销 10:异常详情参考错误码和状态码 |
+tx_id |
string |
上链交易tx_id,以上链后才会设置 |
+asset_info |
object |
资产信息 |
++title |
string |
资产名称 |
++asset_cate |
int |
资产分类。1:艺术品 2:收藏品 3:门票 4:酒店 |
++thumb |
array |
资产图片 |
+++urls |
array |
60、140、360、850四个尺寸的等比缩放后的缩略图链接 |
+++width |
string |
图片的宽 |
+++height |
string |
图片的高 |
++short_desc |
string |
短文字描述 |
++create_addr |
string |
资产创建addr |
++group_id |
int |
资产组id。用于关联业务层酒店/店铺id |
+ctime |
int |
登记时间 |
+mtime |
int |
上链时间秒级时间戳 |
请求示例
Post /xasset/horae/v1/listsdsbyaddr
Host: xuper.baidu.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2022-04-18T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
addr=uoiu789nknmsfsfds
&page=1
&limit=20
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Wed, 18 Apr 2022 03:28:11 GMT
X-Trace-Id: "1182282645"
{
"errmsg": "succ",
"errno": 0,
"request_id": "916556533358021977",
"total_cnt": 10,
"list": [
{
"asset_id": 123,
"shard_id": 123,
"owner_addr": "xxx",
"uid": 123,
"price": 1000,
"status": 0,
"tx_id": "xxx",
"asset_info": {
"title": "xxx",
"asset_cate": 2,
"thumb": [
{
"urls": {
"icon": "https://xxx",
"url1": "https://xxx",
"url2": "https://xxx",
"url3": "https://xxx"
},
"width": "3000",
"height": "2000"
}
],
"short_desc": "xxx",
"create_addr": "xxx"
"group_id": 123",
},
"ctime": 123
"mtime": 123,
},
{
"asset_id": 123,
"shard_id": 123,
"owner_addr": "xxx",
"uid": 123,
"price": 1000,
"status": 0,
"tx_id": "xxx",
"asset_info": {
"title": "xxx",
"asset_cate": 2,
"thumb": [
{
"urls": {
"icon": "https://xxx",
"url1": "https://xxx",
"url2": "https://xxx",
"url3": "https://xxx"
},
"width": "3000",
"height": "2000"
}
],
"short_desc": "xxx",
"create_addr": "xxx"
"group_id": 123",
},
"ctime": 123
"mtime": 123,
}
]
}