全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
更新 SPU
接口地址: http://api.vv-tool.com/tool/erps/productupdateSpu
接口介绍: 更新 SPU
请求方式: POST
返回格式: JSON
接口收费: 联系客服
频率限制: 10 次/秒
请求头参数
参数 | 类型 | 必选 | 值 | 示例 |
---|---|---|---|---|
Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请使用新的生成 token 接口 点击查看详情
请求参数
参数 | 类型 | 必选 | 描述 |
---|---|---|---|
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 | 未授权店铺 | 根据返回链接进行扫码授权 |