拉取address下藏品变更记录
接口描述
- 增量拉取指定address藏品变更记录，用于同步维护address下藏品。
- 需要携带listaddr接口下发的对应token。
- 可以通过该API同步用户藏品到场景端服务器管理。建议在用户活跃时触发惰性检查同步，或者天级周期同步增量。
- 此接口需要联系平台申请授权才可用，需注意用户也可以取消自己的地址对外使用
- 按时间倒序排序
请求结构
POST /xasset/scene/v1/listdiffbyaddr HTTP/1.1
Host: xuper.baidu.com
Authorization: Authorization string
Content-Type: application/x-www-form-urlencoded;charset=utf-8
addr={address}
&token={token}
&limit={limit}
&cursor={cursor}
&op_types={op_types}
请求头域
请求参数
| 参数名 |
参数类型 |
是否可选 |
参数说明 |
| addr |
string |
必选 |
要查询的账户地址 |
| token |
string |
必选 |
listaddr接口下发的对应token |
| limit |
int |
可选 |
默认30，最大50 |
| cursor |
string |
可选 |
首页设置”“,下页携带上页返回值 |
| op_types |
string |
可选 |
要查询的操作类型，[]int格式json串，1:授予 2:转出 3:转入 4:核销 参数示例：[1,2,3] |
响应头域
响应参数
| 参数名称 |
类型 |
描述 |
| errno |
int |
错误码 0为成功，其他可参考常用错误码 |
| request_id |
int |
后端生成，用于问题反馈，建议业务日志纪录 |
| list |
array |
资产信息列表 |
| cursor |
string |
分页游标 |
| has_more |
int |
0:已拉取完成 1:还有剩余数据 |
请求示例
POST /xasset/scene/v1/listdiffbyaddr
Host: xuper.baidu.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2022-04-18T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
addr=bFKZMPVBtUPb1bdoXzWwKX1jaSy9omMjR
&token=B014EDF86B6DEE29E167E9D9ED9C5832
&limit=30
&cursor=""
&op_types=[1,2,3]
响应示例
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,
"reset": 0,
"list": [
{
"asset_id": 123,
"shard_id": 123,
"operate": 1,
"title": "xxx",
"thumb": [
{
"urls": {
"icon": "https://xxx",
"url1": "https://xxx",
"url2": "https://xxx",
"url3": "https://xxx"
},
"width": "3000",
"height": "2000"
}
],
"ctime": 123,
}，
{
"asset_id": 123,
"shard_id": 123,
"operate": 1,
"title": "xxx",
"thumb": [
{
"urls": {
"icon": "https://xxx",
"url1": "https://xxx",
"url2": "https://xxx",
"url3": "https://xxx"
},
"width": "3000",
"height": "2000"
}
],
"ctime": 123,
}，
]
}
