1. 一键导入

接入要求

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

接入样式

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

请求字段

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

参数	类型	描述
userMobile	String	与(userAddress 二选一)
userAddress	String	与(userMobile 二选一)
page	Integer	分页参数，从1累加

响应字段

参数	类型	描述
err	Boolean	是否异常的标识，若有异常，则返回true，若无异常，则返回false
hasNext	Boolean	是否有下一页，缺省值：false
data	Array<Result>	业务数据

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

参数	类型	描述
gNum	String	藏品编号，必填
boughtAt	Long	买⼊时间，毫秒时间戳，必填
cost	Float	买⼊价格（单位元），必填
name	String	藏品名称，必填
imageUrl	String	藏品图片，必填图⽚需要可使⽤提供的地址访问，且必须为 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中的展示位置

响应示例（失败）

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

JSON

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

1. 一键导入 #

接入样式 #

请求字段 #

响应字段 #

响应示例（成功） #