# 更新SPU
接口地址: http://www.damaijia168.com/vv/external/productupdateSpu
请求方式: POST
传参方式: JSON
返回格式: JSON
# 请求头参数
| 参数 | 类型 | 必选 | 值 | 示例 |
|---|---|---|---|---|
| Authorization | string | 是 | 授权 access_token | 1798c6aadec33d1bc2f5b707f1049aefexxxx |
# 请求参数
| 参数 | 类型 | 必选 | 描述 |
|---|---|---|---|
| shop_id | string | 是 | 店铺id |
| id | string | 是 | spu_id,创建时不填,删除更新必填 |
| name | string | 是 | spu标题 |
| ename | string | 否 | spu英文名 |
| alias_name | string | 否 | spu别名 |
| short_name | string | 是 | spu短标题 |
| business_line_id | string | 否 | 业务线条i_d |
| brand_id | string | 是 | 品牌i_d |
| category_id | string | 是 | 末级商品类目i_d |
| attributes | array | 否 | spu属性 |
| --property_id | string | 是 | 属性i_d |
| --name | string | 是 | 属性名 |
| --ename | string | 否 | 属性英文名 |
| --value | string | 否 | 属性值,单选属性使用 |
| --image | object | 否 | 图片 |
| --link | string | 否 | 图片链接 |
| --name | string | 否 | 图片名 |
| --path | string | 否 | 图片路径 |
| --extension | string | 否 | 图片格式 |
| --width | integer | 否 | 宽 |
| --height | integer | 否 | 高 |
| --fingerprint | string | 否 | 图片唯一识别码,请求不填 |
| --image_url | string | 否 | 图片url |
| --type | string | 否 | 属性类型 |
| --value_id | string | 否 | 属性值i_d,单选属性时必填 |
| --value_type | string | 否 | 属性值类型(创建时不填) |
| --value_list | array | 否 | 属性值列表,多选属性填入列表 |
| shipping_template_id | string | 是 | 运费模板i_d |
| shipping_gross_weight | integer | 否 | 商品物流重量(克),当运费模版选择按重量计费时,该值必须大于0 |
| sale_method | string | 否 | 售卖方式 |
| variant_ids | array | 否 | spu下商品规格列表 |
| is_auto_off_sale | boolean | 否 | 是否自动下架,创建不需要,渠道商品更新时候使用 |
| auto_off_sale_time | integer | 否 | 自动下架时间,创建不需要,渠道商品更新时候使用 |
| inventory_type | integer | 否 | 库存类型(1: 普通库存;3: 独立库存),创建不需要,渠道商品更新时候使用,若普通商品修改库存为独立库存可能导致无法售卖 |
| spu_type | string | 否 | spu_type 0:n_or_ma_l(普通商品),1:u_ni_on(组合商品) |
| is_channel | boolean | 否 | 是否为渠道商品,true:是渠道商品,false:非渠道商品 |
| create_time | integer | 否 | spu创建时间 |
| update_time | integer | 否 | spu更新时间 |
| edition | string | 否 | 版本 默认:1(不传默认为1) 1:1.0,2:2.0 |
# 请求示例
{
}
# 请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
Pyton请求代码示例
# 响应参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| data | object | 数据信息 | |
| --id | string | spu标题 | spu_id,创建时不填,删除更新必填 |
| --name | string | spu标题 | spu标题 |
| --ename | string | spu_e_name | spu英文名 |
| --alias_name | string | spu别名 | spu别名 |
| --short_name | string | spu短标题,不得超过30的长度,其中中文字符占两个长度 | spu短标题 |
| --business_line_id | string | 52d0****7d4b | 业务线条i_d |
| --brand_id | string | 52dd****7d4b | 品牌i_d |
| --category_id | string | 5a31****9df5 | 末级商品类目i_d |
| --attributes | array | spu属性 | |
| ----property_id | string | 5845****325e | 属性i_d |
| ----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 | 图片唯一识别码,请求不填 |
| ----image_url | string | http://img.xiaohongshu.com/items/d84***5769 | 图片url |
| ----type | string | s_pl | 属性类型 |
| ----value_id | string | test | 属性值i_d,单选属性时必填 |
| ----value_type | string | l_is_t_v_al_ue/t_ex_t_v_al_ue | 属性值类型(创建时不填) |
| ----value_list | array | 属性值列表,多选属性填入列表 | |
| --shipping_template_id | string | null | 运费模板i_d |
| --shipping_gross_weight | integer | 100 | 商品物流重量(克),当运费模版选择按重量计费时,该值必须大于0 |
| --sale_method | string | d_ef_au_lt/b_ou_ti_qu_e/s_up_er_ma_rk_et | 售卖方式 |
| --variant_ids | array | spu下商品规格列表 | |
| --is_auto_off_sale | boolean | true | 是否自动下架,创建不需要,渠道商品更新时候使用 |
| --auto_off_sale_time | integer | 1617877270000 | 自动下架时间,创建不需要,渠道商品更新时候使用 |
| --inventory_type | integer | 1 | 库存类型(1: 普通库存;3: 独立库存),创建不需要,渠道商品更新时候使用,若普通商品修改库存为独立库存可能导致无法售卖 |
| --spu_type | string | n_or_ma_l | spu_type 0:n_or_ma_l(普通商品),1:u_ni_on(组合商品) |
| --is_channel | boolean | true | 是否为渠道商品,true:是渠道商品,false:非渠道商品 |
| --create_time | integer | spu创建时间 | |
| --update_time | integer | spu更新时间 | |
| --deduct_money | int | 1 | 消耗点券 |
| status | int | 0 | 状态码,0为成功 |
# 返回数据
{
"data": {
"deduct_money":1,
},
"status": 0
}
# 响应代码
| 代码 | 代码描述 | 解决方案 |
|---|---|---|
| 0 | 成功 | |
| 100 | 请求参数错误 | 检查您的请求参数是否正确 |
| 101 | 请求超时,请重试 | 检查您的网络情况或者联系客服解决 |
| 103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
| 200 | 系统错误,请联系客服 | 检查您的接口地址填写是否正确,其他问题联系客服解决 |
| 203 | 暂不支持当前接口 | |
| 204 | 请求异常:无该接口权限,请前往官网开通正式接口。 | 前往官网开通该接口权限 |
| 204 | 请求异常:API调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
| 302 | 未授权店铺 | 根据返回链接进行扫码授权 |