On this page
观察账号接入方式一(藏品列表接入)
接入要求
1、Web3资产支持 GET 请求方式
2、接⼝可使⽤ curl 访问
3、图⽚需要可使⽤提供的地址访问,且必须为 https,否则可能会造成图⽚显示异常
4、若您的地址有防⽕墙,请将以下IP加入白名单中:
101.132.77.44 101.132.122.106 101.132.122.49
106.15.91.193 139.196.124.185 120.55.190.164
47.100.240.73 47.100.1.155 47.100.54.9 47.101.31.59
139.224.235.230
接入效果
图1:Web3资产对接完成后,会在“资产-Web3”界面内显示所有已接入的平台
图2:接入后,用户在导入观察账号时,只需选择平台,填写正确的账号地址,即可查看该账号下的所有资产
图3:导入成功后可查看该地址下的所有藏品
图4:点击单个藏品,可查看该藏品的详细信息
请求字段
我们将使用如下字段对您发起请求
例如:https://yourdomain?wallet=0x76213f1d3e7b240399acd5fcde419828785e0823&pageNo=1&pageSize=20
参数 | 类型 | 描述 |
---|---|---|
wallet | String | 要查询的账号地址,必填,例如:0x76213f1d3e7b240399acd5fcde419828785e0823 |
pageNo | String | 页码,从1开始,必填 |
pageSize | String | 每页数量,必填 |
响应字段
参数 | 类型 | 描述 |
---|---|---|
hasNext | boolean | 是否有下一页,必填 |
data | [object] | 业务数据,响应成功时,返回该地址的藏品列表,必填 |
响应成功后,data列表中的每一个数据需要包含以下参数:
参数 | 类型 | 描述 |
---|---|---|
contract | String | 合约地址,必填 |
contractType | String | 合约类型,例如:ERC721 |
tokenId | String | 藏品ID,必填 |
tokenName | String | 藏品名称,必填 |
tokenImage | String | 藏品的图片地址,必填 图⽚需要可使⽤提供的地址访问,且必须为 https,否则可能会造成图⽚显示异常 |
description | String | 藏品描述 |
mintAt | integer | 用户获取时间 (毫秒级时间戳) |
minter | String | 当前持有者地址,必填 |
响应示例
请使用以下示例给出的结构返回
JSON
{
"hasNext": true,
"data": [
{
"contract": "0xabe733fee0a825b140a0ca10a2c4cda87ad8f2f2",
"contractType": "ERC721",
"tokenId": "1234",
"tokenName": "藏品名称1",
"tokenImage": "https://img.com/img.png",
"description": "描述文案",
"mintAt": 1686538210000,
"minter": "0xedd73c5f32a287b9d3ea36d7cd29c2de6cb0dad9"
},
{
"contract": "0xabe733fee0a825b140a0ca10a2c4cda87ad8f2f2",
"contractType": "ERC721",
"tokenId": "1234",
"tokenName": "藏品名称2",
"tokenImage": "https://img.com/img.png",
"description": "描述文案",
"mintAt": 1686538210000,
"minter": "0xedd73c5f32a287b9d3ea36d7cd29c2de6cb0dad9"
}
]
}
以下为响应成功后各参数在APP中的展示位置