详细描述

用于新添加单个产品

支持平台: 淘宝, 拍拍

API用户类型授权

需授权

系统级别输入参数

名称 类型 是否必须 描述
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

产品结构

XML数据格式:

			
JSON数据格式:
{
    "rsp":"succ",
    "msg_id":3463421b2581604c74dcb9b74ffab2e4,
    "data":{
          "product": {
             "product_id":"200001",
             "created":"2010-03-22 14:22:06",
          }
    }
}

错误码

错误码 错误描述 解决方案

FAQ

修改时间:2012-03-08 17:36:27