Skip to content
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:点击单个藏品,可查看该藏品的详细信息

img

请求字段

我们将使用如下字段对您发起请求

例如:https://yourdomain?wallet=0x76213f1d3e7b240399acd5fcde419828785e0823&pageNo=1&pageSize=20

参数类型描述
walletString要查询的账号地址,必填,例如:0x76213f1d3e7b240399acd5fcde419828785e0823
pageNoString页码,从1开始,必填
pageSizeString每页数量,必填

响应字段

参数类型描述
hasNextboolean是否有下一页,必填
data[object]业务数据,响应成功时,返回该地址的藏品列表,必填

响应成功后,data列表中的每一个数据需要包含以下参数:

参数类型描述
contractString合约地址,必填
contractTypeString合约类型,例如:ERC721
tokenIdString藏品ID,必填
tokenNameString藏品名称,必填
tokenImageString藏品的图片地址,必填
图⽚需要可使⽤提供的地址访问,且必须为 https,否则可能会造成图⽚显示异常
descriptionString藏品描述
mintAtinteger用户获取时间 (毫秒级时间戳)
minterString当前持有者地址,必填

响应示例

请使用以下示例给出的结构返回

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中的展示位置

img