3. 寄售记录

接入要求

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

接入样式

寄售记录接入后，会在对应的藏品详情页展示实时寄售列表

请求字段

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

参数	类型	描述
albumName	String	根据藏品名称获取指定的藏品，必填
limit	Integer	限制返回数量

响应字段

按照挂单价格升序排序，返回最低的50个藏品

参数	类型	描述
data	Array<Result>	业务数据，响应成功时，返回所有的寄售数据

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

参数	类型	描述
orderId	String	原始订单 id，必填
itemName	String	藏品名称，必填
itemNo	String	藏品编号，必填
itemImg	String	藏品图片，必填
priceFen	Integer	寄售价格（单位为分），必填
count	Integer	寄售数量，必填
sellerId	String	卖家 id
sellerName	String	卖家昵称
sellerAddress	String	卖家地址
orderTime	Long	挂单时间
status	Enum<Integer>	当前订单状态，必填，0 = 其它， 1 = 寄售， 2 = 锁定

响应示例

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

JSON

{
  "data":[
        {
          "orderId":"20230308111230301052",
          "itemName":"示例藏品1",
          "itemNo":"1",
          "itemImg":"https://someimage.png",
          "priceFen":100,
          "sellerId":"1011627524",
          "sellerName":"示例卖家1",
          "sellerAddress":"0xasdonondoqe1b",
          "orderTime":1678204800000,
          "status":1,
        },
        {
          "orderId":"20230308111230301051",
          "itemName":"示例藏品2",
          "itemNo":"2",
          "itemImg":"https://someimage.png",
          "priceFen":100,
          "sellerId":"1011627524",
          "sellerName":"示例卖家2",
          "sellerAddress":"0xiovwghli1ds",
          "orderTime":1678204800000,
          "status":1,
        }
    ]
}

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

3. 寄售记录 #

接入样式 #

请求字段 #

响应字段 #

响应示例 #

3. 寄售记录

接入样式

请求字段

响应字段

响应示例