自动跟价列表
查询店铺已设置的自动跟价规则列表,可按 SPU ID 筛选。
一、接口名称
- 接口名称:得物自动跟价列表
- 接口地址:
https://kf.fw199.com/gateway/dewu/bidding/autobiddinglist - 请求方式:
POST - Content-Type:
application/x-www-form-urlencoded
二、请求参数
公共参数
| 参数名 | 类型 | 是否必需 | 说明 |
|---|---|---|---|
| appid | string | 必需 | 开发者 appid |
| timestamp | string | 必需 | 时间戳(秒) |
| sign | string | 必需 | 参数签名 |
业务参数
| 参数名 | 类型 | 是否必需 | 说明 |
|---|---|---|---|
| seller_nick | string | 必需 | 得物店铺标识(授权回调中的 seller_nick) |
| spu_ids | string | 必需 | SPU ID 列表,英文逗号分隔,如 1124090 或 1124090,123456;最多100个 |
| sysid | string | 否 | 应用标识,默认 580 |
三、请求示例代码(Java)
@Test
public void dewuBiddingAutoBiddingList() throws Exception {
String apiUrl = "https://kf.fw199.com/gateway/dewu/bidding/autobiddinglist";
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("spu_ids", "1124090"); // 多个用英文逗号分隔,如 1124090,123456
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": [
{
"bidding_no": "101220045683036245",
"spu_id": 1124090,
"sku_id": 600874591,
"bidding_type": 0,
"follow_type": 3,
"lower_limit": 70800,
"status": true,
"merchant_sku_code": "",
"other_merchant_sku_codes": null
}
],
"trace_id": "b9dfba37-23d8-427d-8130-388c19ec9942"
}4.2 data 说明
data 为数组,元素字段如下:
| 参数名 | 类型 | 说明 |
|---|---|---|
| bidding_no | string | 出价单号 |
| spu_id | number | 商品spuId |
| sku_id | number | 商品skuId |
| bidding_type | number | 出价类型,0:现货、1:预售、7:极速现货、8:极速预售、6:入仓、5:寄售、12:品牌专供现货、13:品牌专供入仓、14:品牌直发 |
| follow_type | number | 跟价规则类型:3:跟随平台最低价、4:比平台最低价低1档(平台最低价>=300元时,1档10元;平台最低价<300元时,1档5元,特殊类目如书籍/影音、食品、酒水、保健品、花卉绿植300元内1档1元。 |
| lower_limit | number | 跟价最低价(下限),单位:分 |
| status | boolean | 自动跟价是否开启 |
| merchant_sku_code | string | 商家商品编码 |
| other_merchant_sku_codes | array / null | 辅助商家商品编码 |
4.3 失败示例
参数错误:
{
"code": 1,
"message": "参数spu_ids无效"
}缺少店铺:
{
"code": 1,
"message": "seller_nick不能为空"
}文档更新时间: 2026-10-25 23:02 作者:admin