历史出价列表

按时间范围分页查询历史出价记录,可按 SKU、商家货号、交易状态等条件筛选。

一、接口名称

  • 接口名称:得物历史出价列表
  • 接口地址:https://kf.fw199.com/gateway/dewu/bidding/historylist
  • 请求方式:POST
  • Content-Type:application/x-www-form-urlencoded

二、请求参数

公共参数

参数名 类型 是否必需 说明
appid string 必需 开发者 appid
timestamp string 必需 时间戳(秒)
sign string 必需 参数签名

业务参数

参数名 类型 是否必需 说明
seller_nick string 必需 得物店铺标识(授权回调中的 seller_nick)
start_time string 必需 开始时间,如 2026-09-01 或 2026-09-01 00:00:00
end_time string 必需 结束时间,如 2026-09-30 或 2026-09-30 23:59:59
page_no number 否 页码,默认 1
page_size number 否 每页条数,默认 20
sku_id number 否 得物 SKU ID
merchant_sku_code string 否 商家货号
other_merchant_sku_code string 否 其他商家货号
trade_status number 否 交易状态
last_id number 否 游标 ID(翻页场景,取上次返回的 last_id)
sysid string 否 应用标识

三、请求示例代码(Java)

@Test
public void dewuBiddingHistoryList() throws Exception {

    String apiUrl = "https://kf.fw199.com/gateway/dewu/bidding/historylist";

    Map<String, String> data = new HashMap<>();
    data.put("appid", Config.AppId);
    data.put("timestamp", String.valueOf(System.currentTimeMillis() / 1000));
    data.put("seller_nick", "your_dewu_seller_nick");
    data.put("sysid", "580");
    data.put("start_time", "2026-09-01");
    data.put("end_time", "2026-09-30");
    data.put("sku_id", "600874591");
    data.put("page_no", "1");
    data.put("page_size", "5");
    data.put("sign", Utils.Sign(data, Config.AppSecret));

    String result = doHttpRequest(apiUrl, data);
    System.out.println("result:" + result);
}

四、响应说明

HTTP 状态码始终为 200,业务成败看 JSON 中的 code 字段(0 表示成功)。

4.1 成功示例

{
  "code": 0,
  "message": "ok",
  "data": {
    "lists": [
      {
        "bid_no": "101220045222079007",
        "spu_id": 1124090,
        "sku_id": 600874591,
        "merchant_sku_code": "",
        "other_merchant_sku_codes": null,
        "quantity": 219,
        "price": 76700,
        "bid_type": 0,
        "trade_status": 2,
        "spu_title": "New Balance NB 2002R 舒适美式复古 织物牛皮革减震耐磨透气 低帮休闲跑步鞋 男女同款 中灰色",
        "create_time": "2026-09-25 19:31:50",
        "modify_time": "2026-09-25 19:31:50"
      },
      {
        "bid_no": "101220045273258551",
        "spu_id": 1124090,
        "sku_id": 600874591,
        "merchant_sku_code": "",
        "other_merchant_sku_codes": null,
        "quantity": 1,
        "price": 76800,
        "bid_type": 0,
        "trade_status": 1,
        "spu_title": "New Balance NB 2002R 舒适美式复古 织物牛皮革减震耐磨透气 低帮休闲跑步鞋 男女同款 中灰色",
        "create_time": "2026-09-29 16:28:01",
        "modify_time": "2026-09-29 16:29:39"
      }
    ],
    "last_id": 1012840043248
  },
  "trace_id": "b704808c-de4c-4168-bedd-2f8c71a2c8fb"
}

4.2 data 主要字段

参数名 类型 说明
lists array 历史出价列表,见下方
last_id number 游标 ID,下一页可传 last_id 继续拉取

lists 元素字段:

参数名 类型 说明
bid_no string 出价单号
spu_id number 得物 SPU ID
sku_id number 得物 SKU ID
merchant_sku_code string 商家货号
other_merchant_sku_codes array 其他商家货号列表
quantity number 数量
price number 出价金额,单位:分
bid_type number 出价类型
trade_status number 交易状态
spu_title string 商品标题
create_time string 创建时间
modify_time string 修改时间

完整字段以上游得物开放平台返回为准;蜂巢将上游 data 对象原样放入响应 data。

4.3 失败示例

参数错误:

{
  "code": 1,
  "message": "参数start_time不能为空"
}

文档更新时间: 2026-09-30 15:14   作者:admin