淘宝开放平台上货接口

-

在我们对接淘宝开放平台的工作中,公司的运营有可能学提出需求让程序员实现软件自动上传宝贝信息,特别是一些sku超级多但是商品信息又比较标准化的品类,比如图书品类。

这就需要调用淘宝开放平台中商品上传接口了,开放平台中关于商品上传的接口,在2022年以前常用的是 taobao.item.add ,但是这个接口在2022年后废弃了,只能用alibaba.item.publish.submit这个接口进行上传了,这个接口稍微会复杂一些,入参主要是xml。以下是该接口的参数,文章末尾有调用这个接口的技巧。

公共参数

请求地址:
环境
HTTP地址
HTTPS地址
正式环境
http://gw.api.taobao.com/router/rest
https://eco.taobao.com/router/rest
公共请求参数:
名称
类型
必须
描述
method
String
API接口名称,例如:alibaba.item.publish.submit
app_key
String
TOP分配给应用的AppKey,例如:12345678
session
String
用户登录授权成功后,TOP颁发给应用的授权信息,详细介绍请点击这里。当此API的标签上注明:“需要授权”,则此参数必传;“不需要授权”,则此参数不需要传;“可选授权”,则此参数为可选
timestamp
String
时间戳,格式为yyyy-MM-dd HH:mm:ss,时区为GMT+8,例如:2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟
v
String
API协议版本,可选值:2.0
sign_method
String
签名的摘要算法,可选值为:hmac,md5,hmac-sha256。
sign
String
API输入参数签名结果,签名算法介绍请点击这里
format
String
响应格式。默认为xml格式,可选值:xml,json。
simplify
Boolean
是否采用精简JSON返回格式,仅当format=json时有效,默认值为:false
公共响应参数:
名称
类型
描述
request_id
String
平台颁发的每次请求访问的唯一标识
error_response
String
请求访问失败时返回的根节点
code
String
请求失败返回的错误码
msg
String
请求失败返回的错误信息
sub_code
String
请求失败返回的子错误码
sub_msg
String
请求失败返回的子错误信息
***_response
String
请求成功返回的根节点,'***' 为API名称的下划线模式

请求参数

名称
类型
必须
示例值
描述
biz_type
String
false
taobao/1.0.0/brandAsyncRenderEnable
业务扩展参数,需与平台约定好
market
String
true
taobao
商品发布的市场。taobao:淘宝,tmall:天猫,litetao:淘宝特价版
cat_id
Number
true
50021288
商品类目ID
spu_id
Number
false
32323
产品ID,天猫市场(market=tmall)时必填
barcode
String
false
6932529211107
商品条码
schema
String
true
<itemSchema></itemSchema>
商品schema信息,通过alibaba.item.publish.props.get获取并补全后提交

响应参数

名称
类型
示例值
描述
create_time
String
2020-12-12 00:00:00
商品创建时间
item_id
Number
634830531619
商品ID
market
String
taobao
商品所属市场

其中 schema参数是核心 ,通过拼装该xml,来进行上传,但是该xml比较复杂,可以通过 alibaba.item.publish.props.get 接口来获取一些参数,但是哪怕是获取到了,拼接也很麻烦,也容易遇到不知道的错误,这个时候有一个技巧就很重要了,你可以先到淘宝后台先手动发布一个宝贝,毕竟手动发布的时候哪些必填哪些不必填,提示的一清二楚,等你手动发布宝贝后,就能在后台看到宝贝的itemid,然后你拿着itemid去调用接口 alibaba.item.edit.schema.get接口来观察一下它的编辑规则,然后也可以调用一下 alibaba.item.publish.schema.get 获取一下这个商品的品类的规则模板,有了发布规则模板+编辑的实际xml,就很容易能修改出一个准确的发布规则xml了。

如果还有疑问可以通过添加我们的微信,来咨询相关操作

本文转载 " 整理 "

原文地址 " "