Skip to content
On this page

3. 寄售记录

接入要求

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

请求字段

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

参数类型描述
albumNameString根据藏品名称获取指定的藏品,必填
limitInteger限制返回数量

响应字段

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

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

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

参数类型描述
orderIdString原始订单 id,必填
itemNameString藏品名称,必填
itemNoString藏品编号,必填
itemImgString藏品图片,必填
priceFenInteger寄售价格(单位为分),必填
countInteger寄售数量,必填
sellerIdString卖家 id
sellerNameString卖家昵称
sellerAddressString卖家地址
orderTimeLong挂单时间
statusEnum<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中的展示位置

img