发布商品
新商品发布,提交商品发布信息
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. 常见问题
如果发布商品时,如果需要运费模板,参考获取运费模板接口。
没有图片空间上传,如何实现上传图片?
使用本接口发布宝贝时, 因为宝贝主图不能为空,可以通过获取宝贝图片-辅助工具获取图片的url(下面简称母图url), 之后可以通过“添加商品图片”接口,给此宝贝上传新的主图,也可用新上传的图片替换掉母图.
文档更新时间: 2023-04-14 22:19 作者:admin