接口描述:

  • 编辑一个商品。

请求 URL:

  • http|https://host/api/v1/goods/method/set.goods.item/

请求方式:

  • GET
  • POST

是否授权:

  • 需要授权

业务参数:

参数名 类型 是否必须 范围值 默认值 示例值 描述
goods_id integer gt:0 1 商品编号
goods_category_id integer gt:0 1 商品分类编号
name string max:200 MateBook 商品名称
short_name string max:50 MateBook 商品短名称
product_name string max:100 XXX促销 商品促销名
goods_code string max:50 CS91785258 商品货号
goods_spu string max:50 123456 商品SPU
goods_sku string max:50 654321 商品SKU
bar_code string max:60 123456 商品条码
brand_id integer egt:0 1 商品品牌编号
store_qty integer egt:0 100 商品库存
market_price number gt:0 7000 商品市场价
shop_price number gt:0 5400 商品本店价
integral_type integer in:0,1 0 赠送积分结算方式
give_integral number 见备注 540 商品赠送积分
is_integral integer egt:0 1000 积分可抵扣额
least_sum integer egt:0 1 最少起订量
purchase_sum integer egt:0 2 限购数量
keywords string max:255 华为 商品关键词
description string max:255 笔记本 商品描述
content string min:0 详情页 商品详情描述
attachment array min:1 ["//image_1.jpg"] 商品相册(至少一张主图)
video string max:255 //video.mp4 商品短视频
unit string max:10 商品计量单位
is_recommend integer in:0,1 1 是否推荐 0=不推 1=推荐
is_new integer in:0,1 1 是否新品 0=不新 1=新品
is_hot integer in:0,1 1 是否热卖 0=普通 1=热卖
goods_type_id integer gt:0 商品模型编号
sort integer between:0,255 50 排序值
status integer in:0,1 1 上下架状态 0=下架 1=上架
goods_attr_item array min[]:0 附属 A 商品属性列表
goods_spec_item array min[]:0 附属 B 商品规格列表
spec_image array min[]:0 附属 C 商品规格图
is_postage integer in:0,1 1 是否包邮 0=收费 1=包邮
measure number egt:0 3 商品计量(重量、体积)
measure_type integer in:0,1,2 0 计量方式 0=重量 1=计件 2=体积
附属 A: 类型 是否必须 范围值 默认值 示例值 描述
goods_attribute_id integer gt:0 1 商品属性编号
parent_id integer egt:0 0 商品属性主体
is_important integer in:0,1 1 是否核心属性 0=普通 1=核心
attr_value string max:150 I5 I7 属性值
sort integer max:150 50 50 排序值

示例 A:

  1. [
  2. {
  3. "goods_attribute_id": 1,
  4. "parent_id": 0,
  5. "is_important": 1,
  6. "attr_value": "I5 I7"
  7. },
  8. {
  9. "goods_attribute_id": 2,
  10. "parent_id": 0,
  11. "is_important": 1,
  12. "attr_value": "8G 16G"
  13. }
  14. ]
附属 B: 类型 是否必须 范围值 默认值 示例值 描述
key_name string max:100 1_3 商品规格键名
key_value string max:60 颜色:黑色 CPU:I5 商品规格值
price number gt:0 5400 商品价格
store_qty integer egt:0 100 商品库存
bar_code string max:60 商品条码
goods_sku string max:50 商品SKU

示例 B:

  1. [
  2. {
  3. "key_name": "1_3",
  4. "key_value": "颜色:黑色 CPU:I5",
  5. "price": 5400,
  6. "store_qty": 100
  7. },
  8. {
  9. "key_name": "1_4",
  10. "key_value": "颜色:黑色 CPU:I7",
  11. "price": 5900,
  12. "store_qty": 100
  13. }
  14. ]
附属 C: 类型 是否必须 范围值 默认值 示例值 描述
spec_item_id integer gt:0 5 商品规格项编号
image string max:255 //image_1.jpg 商品规格图片

示例 C:

  1. [
  2. {
  3. "spec_item_id": "1",
  4. "image": "//image_1.jpg"
  5. },
  6. {
  7. "spec_item_id": "2",
  8. "image": "//image_2.jpg"
  9. }
  10. ]

响应参数:

参数名 类型 是否返回 示例值 描述
status integer 200 状态码
message string success 消息信息
data object [] 返回对象
data 类型 是否返回 示例值 描述
goods_id integer 5 商品编号
goods_category_id integer 1 商品分类编号
name string MateBook 商品名称
short_name string MateBook 商品短名称
product_name string XXX促销 商品促销名
goods_code string CS91785250 商品货号
goods_spu string 123456 商品SPU
goods_sku string 654321 商品SKU
bar_code string 123456 商品条码
brand_id integer 1 商品品牌编号
store_qty integer 200 商品库存
market_price number 7000 商品市场价
shop_price number 5400 商品本店价
integral_type integer 0 赠送积分结算方式
give_integral number 540 商品赠送积分
is_integral integer 1000 积分可抵扣额
least_sum integer 1 最少起订量
purchase_sum integer 2 限购数量
keywords string 华为 商品关键词
description string 笔记本 商品描述
content string 详情页 商品详情描述
attachment array ["//image_1.jpg"] 商品相册
video string //video.mp4 商品短视频
unit string 商品计量单位
is_recommend integer 1 是否推荐 0=不推 1=推荐
is_new integer 1 是否新品 0=不新 1=新品
is_hot integer 1 是否热卖 0=普通 1=热卖
goods_type_id integer 1 商品模型编号
sort integer 50 排序值
status integer 1 上下架状态 0=下架 1=上架
goods_attr_item array [] 商品属性列表数组
goods_spec_item array [] 商品规格列表数组
spec_image array [] 商品规格图数组
is_postage integer 1 是否包邮 0=收费 1=包邮
measure number 3 商品计量(重量、体积)
measure_type integer 0 计量方式 0=重量 1=计件 2=体积
create_time datetime 2018-05-23 00:25:09 创建时间
update_time datetime 2018-05-23 00:25:09 更新时间
goods_attr_item 类型 是否返回 示例值 描述
goods_attribute_id integer 1 商品属性编号
parent_id integer 0 商品属性主体
is_important integer 1 是否核心属性 0=普通 1=核心
attr_value string I5 I7 属性值
sort integer 50 排序值
goods_spec_item 类型 是否返回 示例值 描述
key_name string 1_3 商品规格键名
key_value string 颜色:黑色 CPU:I5 商品规格值
price number 5400 商品价格
store_qty integer 100 商品库存
bar_code string 123456 商品条码
goods_sku string 654321 商品SKU
spec_image 类型 是否返回 示例值 描述
spec_item_id integer 1 商品规格项编号
image string //image_1.jpg 商品规格图片

响应示例:

  1. {
  2. "status": 200,
  3. "message": "success",
  4. "data": {
  5. "goods_id": 5,
  6. "goods_category_id": 1,
  7. "name": "MateBook",
  8. "short_name": "MateBook",
  9. "product_name": "XXX促销",
  10. "goods_code": "CS91785250",
  11. "goods_spu": "123456",
  12. "goods_sku": "654321",
  13. "bar_code": "123456",
  14. "brand_id": 1,
  15. "store_qty": 200,
  16. "market_price": 7000,
  17. "shop_price": 5400,
  18. "integral_type": 0,
  19. "give_integral": 540,
  20. "is_integral": 1000,
  21. "least_sum": 1,
  22. "purchase_sum": 2,
  23. "keywords": "华为",
  24. "description": "笔记本",
  25. "content": "详情页",
  26. "attachment": [
  27. "//image_1.jpg"
  28. ],
  29. "video": "//video.mp4",
  30. "unit": "件",
  31. "is_recommend": 1,
  32. "is_new": 1,
  33. "is_hot": 1,
  34. "goods_type_id": 1,
  35. "sort": 50,
  36. "status": 1,
  37. "goods_attr_item": [
  38. {
  39. "goods_attribute_id": 1,
  40. "parent_id": 0,
  41. "is_important": 1,
  42. "attr_value": "I5 I7"
  43. },
  44. {
  45. "goods_attribute_id": 2,
  46. "parent_id": 0,
  47. "is_important": 1,
  48. "attr_value": "8G 16G"
  49. }
  50. ],
  51. "goods_spec_item": [
  52. {
  53. "key_name": "1_3",
  54. "key_value": "颜色:黑色 CPU:I5",
  55. "price": 5400,
  56. "store_qty": 100
  57. },
  58. {
  59. "key_name": "1_4",
  60. "key_value": "颜色:黑色 CPU:I7",
  61. "price": 5900,
  62. "store_qty": 100
  63. }
  64. ],
  65. "spec_image": [
  66. {
  67. "spec_item_id": 1,
  68. "image": "//image_1.jpg"
  69. },
  70. {
  71. "spec_item_id": 2,
  72. "image": "//image_2.jpg"
  73. }
  74. ],
  75. "is_postage": 1,
  76. "measure": 3,
  77. "measure_type": 0,
  78. "create_time": "2018-05-23 00:25:09",
  79. "update_time": "2018-05-23 00:25:09"
  80. }
  81. }

备注:

  1. 业务参数是否必须一栏中被标注为时,可不填写此参数,表示该接口可单独修改某个字段。

  2. 参数goods_code传入,但值为空时系统自动生成一个。

  3. 其他备注与「添加一个商品」相同。

文档更新时间: 2018-06-22 22:12