发布商品

新商品发布,提交商品发布信息

1.请求参数:

请求URL:

POST https://kf.fw199.com/gateway/alibaba/item/publish/submit

参数名 类型 必须 示例值 说明
appid String uwkahf@jfs92 合作伙伴AppId
timestamp String 1633618722 当前时间戳
tb_seller_nick String kingdo 淘宝卖家店铺登录账号,非店铺名称
sign String 999de41d862efaa6f1084ead3b3ba480 如何计算生成见示例代码
biz_type String false taobao/1.0.0/brandAsyncRenderEnable 业务扩展参数,需与平台约定好
barcode String false 610191026823 商品ID
cat_id Number true 50021288 商品类目ID。若不需要修改商品类目,则不用填写
spu_id Number false 32323 产品ID,天猫市场(market=tmall)时必填
schema Number true <itemSchema> 省略文本</itemSchema> 商品schema信息,通过alibaba.item.publish.props.get获取并补全后提交
market String true taobao 商品发布的市场。taobao:淘宝,tmall:天猫,litetao:淘宝特价版

2. 请求示例代码(Java)

    @Test
    public void  AlibabaItemPublishSubmitRequest() throws Exception {
        String tb_seller_nick = Config.TBSellerNick ;
        //业务参数
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid",  Config.AppId);
        data.put("tb_seller_nick", tb_seller_nick);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("market", "taobao" );
        data.put("cat_id", "50012118" );
//      data.put("barcode", "6932529211107" );
//      data.put("spu_id", "32323" );
        // 由于发布商品schema比较大,放到文件
        Path path = Paths.get("/Users/Tony/itemSchema.txt");
        byte[] fileContent = Files.readAllBytes(path);
        String schema = new String(fileContent, "utf-8");
        data.put("schema", schema);
        data.put("sign", Utils.Sign(data,Config.AppSecret));
        // 调用服务API
        doHttpRequest(Config.AlibabaItemPublishSubmitUrl ,data);

    }

上述发布商品的schema示例下载

3. 返回结果如下

{
    "code":0,
    "message":"ok",
    "data":{
        "create_time":"2021-10-07 21:38:15", // 商品发布时间
        "item_id":657645255129, // 生成的商品Id
        "market":"taobao",
        "request_id":"4hw92z5gd28w"
    },
    "trace_id":""
}

说明: code为0表示成功,非0为失败,message会包含失败原因。

4. 常见问题

  1. 如果发布商品时,如果需要运费模板,参考获取运费模板接口。

  2. 没有图片空间上传,如何实现上传图片?
    使用本接口发布宝贝时, 因为宝贝主图不能为空,可以通过获取宝贝图片-辅助工具获取图片的url(下面简称母图url), 之后可以通过“添加商品图片”接口,给此宝贝上传新的主图,也可用新上传的图片替换掉母图.

文档更新时间: 2023-04-14 22:19   作者:admin