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
接入样式
域名交易接入后,会在社区中有一个单独的话题展示,话题中每一条动态即为每一笔交易
请求字段
我们将使用如下字段对您发起请求,获取start和end之间的域名交易数据
参数 | 类型 | 描述 |
---|---|---|
start | Long | 获取此时间之后交易记录,值为毫秒时间戳,必填,例如:1678413573000 |
end | Long | 获取此时间之前的交易记录,值为毫秒时间戳,必填,例如:1678417173000 |
响应字段
参数 | 类型 | 描述 |
---|---|---|
data | Array<Result> | 业务数据,响应成功时,返回所有的交易数据 |
响应成功后,返回数据中data列表需要包含以下参数:
参数 | 类型 | 描述 |
---|---|---|
contract | String | 合约地址 |
tokenId | String | 藏品的id |
name | String | 域名,必填,例如: 123.d |
image | String | 藏品图片 图⽚需要可使⽤提供的地址访问,且必须为 https,否则可能会造成图⽚显示异常 |
transactionHash | String | 链上交易 hash,如果没有,则给唯一交易 ID,必填 |
from | String | 卖家链上地址,如果没有,则给用户昵称,必填 |
to | String | 买家链上地址,如果没有,则给用户昵称,必填 |
timestamp | Long | 交易时间戳,毫秒时间戳,必填,例如:1678413573000 |
price | Integer | 交易价格(分),必填 |
响应示例
请使用以下示例给出的结构返回
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中的展示位置