用于新添加单个产品
支持平台: 淘宝, 拍拍
用于新添加单个产品
支持平台: 淘宝, 拍拍
需授权
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
method | String | 是 | API接口名称 |
certi_id | Number | 否 | 分配给应用的证书ID |
from_node_id | String | 是 | API调用的来源节点ID,对于第三方开发者来说,此id即为申请应用颁发的APP KEY |
from_api_v | String | 否 | 请求方版本号 |
to_node_id | String | 否 | API调用的目的节点ID(除了基础服务类api,其他接口必传此参数) |
to_api_v | String | 否 | 接收方版本号 |
callback_url | String | 否 | 响应回调地址,带http路径的标准URL。(调用异步接口此参数必填) |
v | String | 是 | 矩阵API协议版本,可选值:1.0 |
timestamp | String | 是 | 时间戳,格式为yyyy-MM-dd hh:mm:ss,例如:2008-01-25 20:23:30。ShopEx API服务端允许客户端请求时间误差为10分钟 |
format | String | 是 | 可选,指定响应格式。默认JSON ,目前支持格式为JSON |
sign | String | 是 | 对调用API时所有输入参数(包括应用级参数)进行签名结果 |
名称 | 类型 |
|
示例值 | 默认值 | 描述 |
---|---|---|---|---|---|
cid | String |
淘宝(必填) 拍拍(必填) |
商品类目ID;注意:必须是叶子类目 id. |
||
outer_id | Number |
淘宝(可选) 拍拍(可选) |
外部产品ID |
||
props | String |
淘宝(可选) 拍拍(可选) |
关键属性 结构:pid:vid;pid:vid.用户自定义属性,请用customer_props. |
||
binds | String |
淘宝(可选) 拍拍(可选) |
非关键属性结构:pid:vid;pid:vid.非关键属性不包含关键属性、销售属性、用户自定义属性、商品属性;注:支持最大长度为512字节 |
||
sale_props | String |
淘宝(必填) 拍拍(必填) |
销售属性结构:pid:vid;pid:vid. |
||
customer_props | Number |
淘宝(可选) 拍拍(可选) |
用户自定义属性,结构:pid1:value1;pid2:value2,如果有型号,系列,货号等用: 隔开 例如:“20000:优衣库:型号:001:632501:1234”,表示“品牌:优衣库:型号:001:货号:1234” |
||
price | Number |
淘宝(可选) 拍拍(可选) |
产品市场价.精确到2位小数;单位为元.如:200.07 |
||
image | String |
淘宝(必填) 拍拍(可选) |
产品主图片.最大1M,目前仅支持GIF,JPG.支持的文件类型:gif,jpg,png,jpeg |
||
name | String |
淘宝(可选) 拍拍(可选) |
产品名称,最大60个字节. |
||
desc | String |
淘宝(可选) 拍拍(可选) |
产品描述.最大25000个字节 |
||
major | String |
淘宝(可选) 拍拍(可选) |
是不是主图 |
||
market_time | String |
淘宝(必填) 拍拍(可选) |
上市时间。目前只支持鞋城类目传入此参数 |
||
property_alias | String |
淘宝(可选) 拍拍(可选) |
销售属性值别名。格式为pid1:vid1:alias1;pid1:vid2:alia2。只有少数销售属性值支持传入别名,比如颜色和尺寸 |
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
product | Product | 是 | 产品结构 |
{ "rsp":"succ", "msg_id":3463421b2581604c74dcb9b74ffab2e4, "data":{ "product": { "product_id":"200001", "created":"2010-03-22 14:22:06", } } }
错误码 | 错误描述 | 解决方案 |
---|