商品

商品列表

  1. GET /goods/list
参数 是否必填 说明
sale_state 否 售卖状态 1出售中 2已售完 3已下架
title 否 商品名称
category_ids 否 分类id 数组格式
order_type 否 1商品价格低到高 2商品价格高到低 3销量多到少 4销量少到多 5库存多到少 6库存少到多 7创建时间早到晚 8创建时间晚到早 9排序高到低 10排序低到高

商品信息

  1. GET /goods/info
参数 是否必填 说明
id 是 商品id

后端注意：

  • 查询的goods_common表
  • goods表可以理解为sku

返回数据结构如下：

  1. {
  2.   id : 1,
  3.   title : 'fashop 撞色休闲假两件连帽外套女2017秋装长袖外套',
  4.   images : [
  5.     {
  6.       id : 1,
  7.       url : 'http://xxx.jpg',
  8.     },
  9.     {
  10.       id : 2,
  11.       url : 'http://xxx.jpg',
  12.     },
  13.     {
  14.       id : 3,
  15.       url : 'http://xxx.jpg',
  16.     }
  17.   ],
  18.   category_ids : [1,23,6,335,],
  19.   base_sale_num  : 367,
  20.   freight_template_id : 1,
  21.   send_area_id  : 1,
  22.   body : [],
  23.   is_on_sale : 1,
  24.   use_image_spec_id  : 1,
  25.   skus : [
  26.       {
  27.         "spec": [
  28.           {
  29.           "id": 20509,
  30.           "value_id": 28313,
  31.           "name": "尺码",
  32.           "value_name": "XS",
  33.           },
  34.           {
  35.           "id": 20509,
  36.           "value_id": 28213,
  37.           "name": "颜色",
  38.           "value_name": "墨绿色",
  39.           },
  40.         ],
  41.         "price": 23,
  42.         "stock": 23,
  43.         "code": "商品编号",
  44.         "weight": 0, // 重量，当选择按重量计算的运费模板时才出现
  45.       },
  46.       {
  47.         "spec_list": [
  48.           {
  49.           "id": 20509,
  50.           "value_id": 28313,
  51.           "name": "尺码",
  52.           "value_name": "XS",
  53.           },
  54.           {
  55.           "id": 20509,
  56.           "value_id": 28212,
  57.           "name": "颜色",
  58.           "value_name": "红色",
  59.           },
  60.         ],
  61.         "price": 23,
  62.         "stock": 23,
  63.         "code": "商品编号",
  64.         "weight": 0, // 重量，当选择按重量计算的运费模板时才出现
  65.       },
  66.     ]
  67. }

添加商品

  1. POST - /goods/add
参数 是否必填 说明
title 是 商品标题
images 是 商品图片，数组，默认第一个为封面图片
category_ids 是 商品分类id集合，数组
base_sale_num 是 基础销量，为空请输入0
freight_id 是 运费模板id
freight_fee 否 统一运费，默认为0
sale_time 是 开售时间，立即开始传当前时间
body 是 商品详情，json
is_on_sale 是 是否需上架出售 0 否 1 是
image_spec_id 否 使用图片的规格id
skus 是 sku商品集合，数组
skus.spec 否 sku规格
skus.spec.id 否 sku规格id
skus.spec.name 否 sku规格值id
skus.spec.value_id 否 sku规格名
skus.spec.value_name 否 sku规格值名
skus.spec.value_image 否 sku规格图片
skus.price 否 sku价格
skus.stock 否 sku库存
skus.code 否 sku商家编号
skus.img 否 sku图片
skus.weight 否 sku重量(kg)

sku商品集合数据格式如下：

如果就一个商品，传一条即可

无规格商品：

  1. [
  2.   {
  3.     "spec": [
  4.       {
  5.       "id": 0,
  6.       "name": null,
  7.       "value_id": 0,
  8.       "value_name": null,
  9.       }
  10.     ],
  11.     "price": 23,
  12.     "stock": 23,
  13.     "code": "商品编号",
  14.     "weight": 0, // 重量，当选择按重量计算的运费模板时才出现
  15.   }
  16. ]

有规格商品：

  1. [
  2.   {
  3.     "spec": [
  4.       {
  5.       "id": 20509,
  6.       "value_id": 28313,
  7.       "name": "尺码",
  8.       "value_name": "XS",
  9.       "value_img": "http://xxxxxxxxxxxxx.jpg", // 如果规格设置了图片才有该字段
  10.       },
  11.       {
  12.       "id": 20509,
  13.       "value_id": 28213,
  14.       "name": "颜色",
  15.       "value_name": "墨绿色",
  16.       },
  17.     ],
  18.     "price": 23,
  19.     "stock": 23,
  20.     "code": "商品编号",
  21.     "weight": 0, // 重量，当选择按重量计算的运费模板时才出现
  22.   },
  23.   {
  24.     "spec": [
  25.       {
  26.       "id": 20509,
  27.       "value_id": 28313,
  28.       "name": "尺码",
  29.       "value_name": "XS",
  30.       "value_img": "http://xxxxxxxxxxxxx.jpg", // 如果规格设置了图片才有该字段
  31.       },
  32.       {
  33.       "id": 20509,
  34.       "value_id": 28212,
  35.       "name": "颜色",
  36.       "value_name": "红色",
  37.       "value_img": "http://xxxxxxxxxxxxx.jpg", // 如果规格设置了图片才有该字段
  38.       },
  39.     ],
  40.     "price": 23,
  41.     "stock": 23,
  42.     "code": "商品编号",
  43.     "weight": 0, // 重量，当选择按重量计算的运费模板时才出现
  44.   },
  45. ]

body字段说明：

  1. {
  2.     "type" : "text",
  3.     "value" : {
  4.         "content" : "文字"
  5.     }
  6. },
  7. {
  8.     "type" : "image",
  9.     "value" : {
  10.         "url" : "http://xxxx.jpg"
  11.      }
  12. },
  13. {
  14.     "type" : "video",
  15.     "value" : {
  16.         "url" : "http://xxxx.xxx"
  17.      }
  18. },
  19. {
  20.     "type" : "goods",
  21.     "value" : 
  22.         { 
  23.           "id" : 1,
  24.           "img" : {
  25.             "url" : "http://xxxx.jpg"
  26.           },
  27.           "title" : "测试商品",
  28.           "price" : 200,
  29.           "desc" : "描述"
  30.         }
  32. },
  33. {
  34.     "type" : "separator"
  35. }

修改商品

  1. POST - /goods/edit
参数 是否必填 说明
id 是 商品id
title 是 商品标题
images 是 商品封面图片
category_ids 是 商品分类id集合，数组
base_sale_num 否 基础销量，为空请输入0
freight_template_id 否 运费模板id
freight 否 统一运费，默认为0
sale_time 是 开售时间，立即开始传当前时间
body 是 商品详情，json
is_on_sale 是 是否需上架出售 0 否 1 是
use_image_spec_id 否 使用图片的规格id
skus 是 sku商品集合，数组
skus.spec 否 sku规格
skus.spec.id 否 sku规格id
skus.spec.name 否 sku规格值id
skus.spec.value_id 否 sku规格名
skus.spec.value_name 否 sku规格值名
skus.id 否 sku id
skus.price 否 sku价格
skus.stock 否 sku库存
skus.code 否 sku商家编号
skus.weight 否 sku重量(kg)

商品删除

  1. POST - /goods/del
参数 是否必填 说明
goods_ids 是 商品id集合 数组形式

注意：后端为加删除，真删除了关联的数据恐怕有bug，后台所有删除为假删除

商品下架

  1. POST - /goods/offSale
参数 是否必填 说明
goods_ids 是 商品id集合 数组形式

商品上架

  1. POST - /goods/onSale
参数 是否必填 说明
goods_ids 是 商品id集合 数组形式

商品sku列表

  1. GET - /goods/skuList
参数 是否必填 说明
goods_id 是 商品id