商品发布 schema 提交

商品发布 schema 提交

一、接口名称

抖店商品发布 schema 提交

• 接口地址：https://kf.fw199.com/gateway/dd/product/addschema
• 请求方式：POST

按抖店 schema 规则提交商品发布数据。建议先调 POST /gateway/dd/product/getschema 拿到类目 schema，填充后再调用本接口。

二、请求参数

公共参数

业务参数

三、请求示例代码（Java）

@Test
public void ddProductAddSchema() throws Exception {

    String apiUrl = "https://kf.fw199.com/gateway/dd/product/addschema";
    String sellerNick = "158458425";

    // model：按 getSchema 返回的 schema 填充后的 JSON
    String model = "{\"name\":\"测试商品－请勿购买\",\"category_id\":31860}";

    Map<String, String> data = new HashMap<>();
    data.put("appid", Config.AppId);
    data.put("timestamp", String.valueOf(System.currentTimeMillis() / 1000));
    data.put("seller_nick", sellerNick);
    data.put("sysid", "xxxxx");
    data.put("model", model);
    data.put("commit", "true");
    data.put("sign", Utils.Sign(data, Config.AppSecret));

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

四、返回结果

说明：

• HTTP 状态码始终为 200，业务成败看 JSON 中的 code
• 最外层 code 为 0 表示蜂巢调用成功；非 0 为失败，message 含失败原因
• 成功时 data 为抖店 /product/addSchema 的业务结果（结构以官方为准）

4.1 成功示例

{
  "data": {
    "product_id": "123",
    "sku": [
      {
        "code": "1234",
        "out_sku_id": "123",
        "outer_sku_id": "1234",
        "sku_id": "123"
      }
    ]
  },
  "code": 10000,
  "msg": "success",
  "sub_code": "",
  "sub_msg": ""
}

4.2 data 字段说明

data 其它字段以抖店官方响应为准，蜂巢原样返回。