历史出价列表
按时间范围分页查询历史出价记录,可按 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