分页拉取指定address下的藏品变更记录
接口描述
- 本接口用于增量拉取指定address藏品变更记录，用于同步维护address下藏品。
- 可以通过该API同步用户藏品到场景端服务器管理。建议在用户活跃时触发惰性检查同步，或者天级周期同步增量等。
请求结构
POST /xasset/horae/v1/listsdsbyast HTTP/1.1
Host: xuper.baidu.com
Authorization: Authorization string
Content-Type: application/x-www-form-urlencoded;charset=utf-8
addr={addr}
&cursor={cursor}
&limit={limit}
&op_types={op_types}
请求头域
请求参数
| 参数名 |
参数类型 |
是否可选 |
参数说明 |
| addr |
string |
必选 |
要查询的账户地址 |
| cursor |
string |
可选 |
首页设置”“,下页携带上页返回值 |
| limit |
int |
可选 |
默认30，最大50 |
| op_types |
string |
可选 |
要查询的操作类型，[]int格式json串，1:授予 2:转出 3:转入 4:核销 一次查询不超过4个 |
响应头域
响应参数
| 参数名 |
参数类型 |
参数说明 |
| errmsg |
string |
错误信息 |
| errno |
int |
错误码 详情参考错误码和状态码 |
| request_id |
int |
后端生成，用于问题反馈，建议业务日志纪录 |
| cursor |
string |
分页游标 |
| list |
array |
资产信息 |
| +shard_id |
int64 |
资产碎片id |
| +asset_id |
int64 |
资产id |
| +operate |
int |
查询类型 1:授予 2:转出 3:转入 4:核销 |
| +title |
string |
资产标题 |
| +thumb |
array |
地址信息 |
| +ctime |
int |
登记时间 |
请求示例
Post /xasset/horae/v1/listsdsbyast
Host: xuper.baidu.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2022-04-18T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
addr=uoiu789nknmsfsfds
&cursor=
&limit=30
响应示例
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"
{
"errno": 0，
"request_id": "916556533358021977",
"cursor": "xxxxxxxxxx",
"has_more": 0,
"list": [
{
"asset_id": 123,
"shard_id": 123,
"operate": 1,
"title": "xxx",
"thumb": {
"icon": "https://xxx",
"url1": "https://xxx",
"url2": "https://xxx",
"url3": "https://xxx"
},
"ctime": 123456,
}，
{
"asset_id": 123,
"shard_id": 123,
"operate": 1,
"title": "xxx",
"thumb": {
"icon": "https://xxx",
"url1": "https://xxx",
"url2": "https://xxx",
"url3": "https://xxx"
},
"ctime": 123456,
}，
]
}
