V兔API开放平台

参数	类型	必选	描述
shop_id	string	是	店铺 id
id	string	是	spuId,创建时不填，删除更新必填
name	string	是	spu 标题
ename	string	否	spu 英文名
aliasName	string	否	spu 别名
shortName	string	是	spu 短标题
businessLineId	string	否	业务线条 ID
brandId	string	是	品牌 ID
categoryId	string	是	末级商品类目 ID
attributes	array	否	spu 属性
--propertyId	string	是	属性 ID
--name	string	是	属性名
--ename	string	否	属性英文名
--value	string	否	属性值，单选属性使用
--image	object	否	图片
--link	string	否	图片链接
--name	string	否	图片名
--path	string	否	图片路径
--extension	string	否	图片格式
--width	integer	否	宽
--height	integer	否	高
--fingerprint	string	否	图片唯一识别码，请求不填
--imageUrl	string	否	图片 url
--type	string	否	属性类型
--valueId	string	否	属性值 ID，单选属性时必填
--valueType	string	否	属性值类型(创建时不填)
--valueList	array	否	属性值列表，多选属性填入列表
shippingTemplateId	string	是	运费模板 ID
shippingGrossWeight	integer	否	商品物流重量（克），当运费模版选择按重量计费时，该值必须大于 0
saleMethod	string	否	售卖方式
variantIds	array	否	spu 下商品规格列表
isAutoOffSale	boolean	否	是否自动下架，创建不需要，渠道商品更新时候使用
autoOffSaleTime	integer	否	自动下架时间，创建不需要，渠道商品更新时候使用
inventoryType	integer	否	库存类型（1: 普通库存；3: 独立库存），创建不需要，渠道商品更新时候使用，若普通商品修改库存为独立库存可能导致无法售卖
spuType	string	否	spuType 0:NORMAL(普通商品),1:UNION(组合商品)
isChannel	boolean	否	是否为渠道商品，true:是渠道商品，false：非渠道商品
createTime	integer	否	spu 创建时间
updateTime	integer	否	spu 更新时间

请求示例

请求代码示例

cURL请求代码示例

PHP请求代码示例

JAVA请求代码示例

响应参数

名称	类型	示例值	描述
code	int	返回状态码
msg	string	返回码描述
msec	int	接口执行时间
time	int	接口返回时间
data	object	数据信息
--withholding_money	int		该接口扣费金额（点券）
--id	string	spu 标题	spuId,创建时不填，删除更新必填
--name	string	spu 标题	spu 标题
--ename	string	spuEName	spu 英文名
--aliasName	string	spu 别名	spu 别名
--shortName	string	spu 短标题，不得超过 30 的长度，其中中文字符占两个长度	spu 短标题
--businessLineId	string	52d0****7d4b	业务线条 ID
--brandId	string	52dd****7d4b	品牌 ID
--categoryId	string	5a31****9df5	末级商品类目 ID
--attributes	array		spu 属性
----propertyId	string	5845****325e	属性 ID
----name	string	测试属性名 01	属性名
----ename	string	attributetest01	属性英文名
----value	string	test	属性值，单选属性使用
----image	object		图片
----link	string	http://img.xiaohongshu.com/items/d84***5769	图片链接
----name	string	图片 1	图片名
----path	string	arkgoods/925****7304b	图片路径
----extension	string	.png	图片格式
----width	integer	800	宽
----height	integer	800	高
----fingerprint	string	2495234395712979	图片唯一识别码，请求不填
----imageUrl	string	http://img.xiaohongshu.com/items/d84***5769	图片 url
----type	string	SPL	属性类型
----valueId	string	test	属性值 ID，单选属性时必填
----valueType	string	LIST_VALUE/TEXT_VALUE	属性值类型(创建时不填)
----valueList	array		属性值列表，多选属性填入列表
--shippingTemplateId	string	null	运费模板 ID
--shippingGrossWeight	integer	100	商品物流重量（克），当运费模版选择按重量计费时，该值必须大于 0
--saleMethod	string	DEFAULT/BOUTIQUE/SUPERMARKET	售卖方式
--variantIds	array		spu 下商品规格列表
--isAutoOffSale	boolean	True	是否自动下架，创建不需要，渠道商品更新时候使用
--autoOffSaleTime	integer	1617877270000	自动下架时间，创建不需要，渠道商品更新时候使用
--inventoryType	integer	1	库存类型（1: 普通库存；3: 独立库存），创建不需要，渠道商品更新时候使用，若普通商品修改库存为独立库存可能导致无法售卖
--spuType	string	NORMAL	spuType 0:NORMAL(普通商品),1:UNION(组合商品)
--isChannel	boolean	True	是否为渠道商品，true:是渠道商品，false：非渠道商品
--createTime	integer		spu 创建时间
--updateTime	integer		spu 更新时间

返回数据

响应代码

代码	代码描述	解决方案
0	成功
100	请求参数错误	检查您的请求参数是否正确
101	请求超时，请重试	检查您的网络情况或者联系客服解决
103	旺旺账号不存在	检查您输入的旺旺号是否正确
200	系统错误，请联系客服	检查您的接口地址填写是否正确，其他问题联系客服解决
203	暂不支持当前接口
204	请求异常：无该接口权限，请前往官网开通正式接口。	前往官网开通该接口权限
204	请求异常：API 调用次数不足，请前往网站兑换次数。	前往官网充值该接口调用次数
302	未授权店铺	根据返回链接进行扫码授权

创建 SPU

请求头参数

请使用新的生成 token 接口 点击查看详情

请求参数

请求示例

请求代码示例

响应参数

返回数据

响应代码

请使用新的生成 token 接口点击查看详情