自动跟价详情

按出价单号查询自动跟价详情（跟价类型、下限价、规则等）。

一、接口名称

  • 接口名称：得物自动跟价详情
  • 接口地址：https://kf.fw199.com/gateway/dewu/bidding/autobiddingdetail
  • 请求方式：POST
  • Content-Type：application/x-www-form-urlencoded

二、请求参数

公共参数

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

业务参数

参数名 类型 是否必需 说明
seller_nick string 必需 得物店铺标识（授权回调中的 seller_nick）
bidding_no string 必需 出价单号
sysid string 否 应用标识，默认 580

三、请求示例代码（Java）

@Test
public void dewuBiddingAutoBiddingDetail() throws Exception {

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

    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("bidding_no", "101220045683036245");
    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",
    "follow_type": 3,
    "lower_limit": 70800,
    "source": "",
    "name": "",
    "global_min_price": 0,
    "rules": [
      {
        "rule": "",
        "type": 0
      }
    ]
  },
  "trace_id": "b9dfba37-23d8-427d-8130-388c19ec9942"
}

以上为字段结构示意；source / name / global_min_price / rules 等以上游实际返回为准。

4.2 data 说明

参数名 类型 说明
bidding_no string 出价单号
follow_type number 跟价规则类型：3：跟随平台最低价、4：比平台最低价低1档（平台最低价>=300元时，1档10元；平台最低价<300元时，1档5元，特殊类目如书籍/影音、食品、酒水、保健品、花卉绿植300元内1档1元。
lower_limit number 跟价最低价（下限），单位：分
source string 来源
name string 名称
global_min_price number 全网最低价，单位：分
rules array 跟价规则列表，见下方

rules 元素字段：

参数名 类型 说明
rule string 跟价规则
type number 跟价类型值

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

4.3 失败示例

参数错误：

{
  "code": 1,
  "message": "参数bidding_no不能为空"
}
文档更新时间: 2026-10-25 23:25   作者：admin