Skip to content
On this page

1. 一键导入

接入要求

1、一键导入支持 GET 请求方式,支持分页

2、接⼝可使⽤ curl 访问

3、图⽚需要可使⽤提供的地址访问,且必须为 https,否则可能会造成图⽚显示异常

4、若您的地址有防⽕墙,请将以下IP加入白名单中:

101.132.77.44   101.132.122.106   120.55.190.164   
106.15.91.193   139.196.124.185   101.132.122.49
47.100.240.73   47.100.1.155   47.100.54.9   47.101.31.59

接入样式

接入后,在一键导入列表会展示对应的平台,用户可快速导入持有的全部藏品数据

img

请求字段

我们将使用如下字段对您发起请求,一键导入支持手机号和地址两种(二选一)导入方式,使用的请求参数不同

参数类型描述
userMobileString与(userAddress 二选一)
userAddressString与(userMobile 二选一)
pageInteger分页参数,从1累加

响应字段

参数类型描述
errBoolean是否异常的标识,若有异常,则返回true,若无异常,则返回false
hasNextBoolean是否有下一页,缺省值:false
dataArray<Result>业务数据

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

参数类型描述
gNumString藏品编号,必填
boughtAtLong买⼊时间,毫秒时间戳,必填
costFloat买⼊价格(单位元),必填
nameString藏品名称,必填
imageUrlString藏品图片,必填
图⽚需要可使⽤提供的地址访问,且必须为 https,否则可能会造成图⽚显示异常

响应示例(成功)

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

JSON
{
  "err": false,
  "data": [
    {
      "gNum": "16105",
      "boughtAt": 1655619105000,
      "cost": 99.99,
      "name": "拾光者",
      "imageUrl": "https://static.ibox.art/file/oss/test/image/nft-goods/5"
    },
    {
      "gNum": "16106",
      "boughtAt": 1655619105000,
      "cost": 99.99,
      "name": "拾光者",
      "imageUrl": "https://static.ibox.art/file/oss/test/image/nft-goods/5"
    }
  ]
}

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

img

响应示例(失败)

响应失败后,我们会将错误信息以toast的形式展示给用户

JSON
{
  "err": true,
  "msg": "用户不存在" // 错误原因,会透传给用户
}