Skip to content
On this page

4. 域名交易

接入要求

1、域名交易支持 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

接入样式

域名交易接入后,会在社区中有一个单独的话题展示,话题中每一条动态即为每一笔交易

img

请求字段

我们将使用如下字段对您发起请求,获取start和end之间的域名交易数据

参数类型描述
startLong获取此时间之后交易记录,值为毫秒时间戳,必填,例如:1678413573000
endLong获取此时间之前的交易记录,值为毫秒时间戳,必填,例如:1678417173000

响应字段

参数类型描述
dataArray<Result>业务数据,响应成功时,返回所有的交易数据

响应成功后,返回数据中data列表需要包含以下参数:

参数类型描述
contractString合约地址
tokenIdString藏品的id
nameString域名,必填,例如: 123.d
imageString藏品图片
图⽚需要可使⽤提供的地址访问,且必须为 https,否则可能会造成图⽚显示异常
transactionHashString链上交易 hash,如果没有,则给唯一交易 ID,必填
fromString卖家链上地址,如果没有,则给用户昵称,必填
toString买家链上地址,如果没有,则给用户昵称,必填
timestampLong交易时间戳,毫秒时间戳,必填,例如:1678413573000
priceInteger交易价格(分),必填

响应示例

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

JSON
{
  "err": false,
  "data": [
    {
      "contract": "0x11111111111111",
      "tokenId": "1234",
      "name": "nice.vip",
      "image": "http://img.png",
      "transactionHash": "0x11111111",
      "from": "0x1111111",
      "to": "0x2222222222",
      "timestamp": 1686195284000,
      "price": 10000
    },
    {
      "contract": "0x11111111111111",
      "tokenId": "1234",
      "name": "nice.vip",
      "image": "http://img.png",
      "transactionHash": "0x11111111",
      "from": "0x1111111",
      "to": "0x2222222222",
      "timestamp": 1686195284000,
      "price": 10000
    }
  ]
}

以下为响应成功后各参数在APP中的展示位置

img