商品详情(详细)

简要描述
  • 获取指定商品的详情信息(详细)
请求url
  • https://www.商城域名.com/index.php?s=/api/goods/detail
请求方式
  • GET
是否需授权登录
请求header
参数名 类型 是否必须 示例值 说明
storeId int 必填 10001 商城ID
platform string 必填 H5 当前请求的客户端(APP、小程序、H5等)
Access-Token string 选填 - 当前登录用户的 Token
请求参数
参数名 类型 是否必须 示例值 说明
goodsId int 必填 10001 商品ID
返回示例
{
  "status": 200,
  "message": "success",
  "data": {
    "detail": {
      "goods_id": 10006,
      "goods_name": "小米(MI) 红米6 流沙金 全网通(3G RAM+32G ROM)",
      "goods_no": "",
      "video_id": 0,
      "video_cover_id": 0,
      "selling_point": "",
      "spec_type": 20,
      "goods_price_min": "724.22",
      "goods_price_max": "979.02",
      "line_price_min": "0.00",
      "line_price_max": "0.00",
      "stock_total": 0,
      "content": "<p><img src=\"https://img30.360buyimg.com/popWaterMark/jfs/t21079/308/1123537364/204877/c72aad08/5b2091e8N5871b64d.jpg.dpg\"/></p>",
      "delivery_id": 10001,
      "is_points_gift": 1,
      "is_points_discount": 1,
      "is_alone_points_discount": 0,
      "points_discount_config": "",
      "is_enable_grade": 1,
      "is_alone_grade": 0,
      "alone_grade_equity": [],
      "status": 10,
      "is_ind_dealer": 0,
      "dealer_money_type": 10,
      "first_money": "0.00",
      "second_money": "0.00",
      "third_money": "0.00",
      "goods_images": [
        {
          "file_id": 10073,
          "file_type": 10,
          "preview_url": "2018071716364761fab9153.jpg",
          "external_url": "2018071716364761fab9153.jpg"
        },
        {
          "file_id": 10071,
          "file_type": 10,
          "preview_url": "201807171636464817e0710.jpg",
          "external_url": "201807171636464817e0710.jpg"
        },
        {
          "file_id": 10074,
          "file_type": 10,
          "preview_url": "201807171636470c35f4034.jpg",
          "external_url": "201807171636470c35f4034.jpg"
        }
      ],
      "goods_image": "2018071716364761fab9153.jpg",
      "goods_sales": 0,
      "is_user_grade": true,
      "specList": [
        {
          "spec_id": 10001,
          "spec_name": "颜色",
          "key": 0,
          "valueList": [
            {
              "key": 0,
              "groupKey": 0,
              "spec_value_id": 10001,
              "spec_value": "流沙金"
            },
            {
              "key": 1,
              "groupKey": 0,
              "spec_value_id": 10002,
              "spec_value": "巴厘蓝"
            },
            {
              "key": 2,
              "groupKey": 0,
              "spec_value_id": 10003,
              "spec_value": "樱花粉"
            },
            {
              "key": 3,
              "groupKey": 0,
              "spec_value_id": 10004,
              "spec_value": "铂银灰"
            }
          ]
        },
        {
          "spec_id": 10002,
          "spec_name": "版本",
          "key": 1,
          "valueList": [
            {
              "key": 0,
              "groupKey": 1,
              "spec_value_id": 10005,
              "spec_value": "全网通(3G RAM+32G ROM)"
            }
          ]
        }
      ],
      "skuList": [
        {
          "id": 10198,
          "goods_sku_id": "10001_10005",
          "goods_id": 10006,
          "image_id": 0,
          "goods_sku_no": "",
          "goods_price": "734.02",
          "line_price": "0.00",
          "stock_num": 250,
          "goods_weight": 0.15,
          "goods_props": [
            {
              "group": {
                "name": "颜色",
                "id": 10001
              },
              "value": {
                "name": "流沙金",
                "id": 10001
              }
            },
            {
              "group": {
                "name": "版本",
                "id": 10002
              },
              "value": {
                "name": "全网通(3G RAM+32G ROM)",
                "id": 10005
              }
            }
          ],
          "spec_value_ids": [
            10001,
            10005
          ],
          "image_url": null
        },
        {
          "id": 10199,
          "goods_sku_id": "10002_10005",
          "goods_id": 10006,
          "image_id": 0,
          "goods_sku_no": "",
          "goods_price": "979.02",
          "line_price": "0.00",
          "stock_num": 200,
          "goods_weight": 0.15,
          "goods_props": [
            {
              "group": {
                "name": "颜色",
                "id": 10001
              },
              "value": {
                "name": "巴厘蓝",
                "id": 10002
              }
            },
            {
              "group": {
                "name": "版本",
                "id": 10002
              },
              "value": {
                "name": "全网通(3G RAM+32G ROM)",
                "id": 10005
              }
            }
          ],
          "spec_value_ids": [
            10002,
            10005
          ],
          "image_url": null
        },
        {
          "id": 10200,
          "goods_sku_id": "10003_10005",
          "goods_id": 10006,
          "image_id": 0,
          "goods_sku_no": "",
          "goods_price": "724.22",
          "line_price": "0.00",
          "stock_num": 200,
          "goods_weight": 0.15,
          "goods_props": [
            {
              "group": {
                "name": "颜色",
                "id": 10001
              },
              "value": {
                "name": "樱花粉",
                "id": 10003
              }
            },
            {
              "group": {
                "name": "版本",
                "id": 10002
              },
              "value": {
                "name": "全网通(3G RAM+32G ROM)",
                "id": 10005
              }
            }
          ],
          "spec_value_ids": [
            10003,
            10005
          ],
          "image_url": null
        },
        {
          "id": 10201,
          "goods_sku_id": "10004_10005",
          "goods_id": 10006,
          "image_id": 0,
          "goods_sku_no": "",
          "goods_price": "724.22",
          "line_price": "0.00",
          "stock_num": 200,
          "goods_weight": 0.15,
          "goods_props": [
            {
              "group": {
                "name": "颜色",
                "id": 10001
              },
              "value": {
                "name": "铂银灰",
                "id": 10004
              }
            },
            {
              "group": {
                "name": "版本",
                "id": 10002
              },
              "value": {
                "name": "全网通(3G RAM+32G ROM)",
                "id": 10005
              }
            }
          ],
          "spec_value_ids": [
            10004,
            10005
          ],
          "image_url": null
        }
      ],
      "video": null,
      "videoCover": null
    }
  }
}
返回参数
参数名 类型 示例值 说明
status int 200 请求状态(200:请求成功;500:请求错误/失败)
message string success 请求结果的信息,默认为 success
data object - 返回的业务数据
data 参数
参数名 类型 示例值 说明
detail object - 商品详情信息
data.detail 参数
参数名 类型 示例值 说明
goods_id int 10006 商品ID
goods_name string 小米(MI) 红米6 流沙金... 商品标题/名称
goods_no string - 商品编号
video_id int - 主图视频ID
video_cover_id int - 主图视频封面ID
selling_point string - 商品卖点
spec_type int 20 商品规格 (10单规格 20多规格)
goods_price_min string 724.22 商品价格 (最低)
goods_price_max string 979.02 商品价格 (最高)
line_price_min string 0.00 划线价格 (最低)
line_price_max string 0.00 划线价格 (最高)
stock_total int - 库存总量 (包含所有sku)
content string - 详情页内容
delivery_id int 10001 配送模板ID
is_points_gift int 1 是否开启积分赠送 (1开启 0关闭)
is_points_discount int 1 是否允许使用积分抵扣 (1允许 0不允许)
is_enable_grade int 1 是否开启会员折扣 (1开启 0关闭)
is_alone_grade int - 会员折扣设置 (0默认等级折扣 1单独设置折扣)
alone_grade_equity array - 单独设置折扣的配置
status int 10 商品状态 (10上架 20下架)
is_ind_dealer int - 是否开启单独分销 (0关闭 1开启)
dealer_money_type int 10 分销佣金类型 (10百分比 20固定金额)
first_money string 0.00 分销佣金 (一级)
second_money string 0.00 分销佣金 (二级)
third_money string 0.00 分销佣金 (三级)
goods_images array - 商品轮播图
goods_image string 2018071716364761fab9153.jpg 商品主图URL
goods_sales int - 显示销量 (初始销量 + 实际销量)
is_user_grade boolean true 是否使用会员等级折扣价(判断登录用户的会员等级)
specList array - 商品规格列表
skuList array - 商品SKU列表
video null null 商品主图视频信息
videoCover null null 商品主图视频封面信息
data.detail.goods_images 参数
参数名 类型 示例值 说明
file_id int 10073 文件ID
file_type int 10 文件类型 (10图片)
preview_url string 2018071716364761fab9153.jpg 图片预览地址
data.detail.goods_images.specList 参数
参数名 类型 示例值 说明
spec_id int 10001 规格组ID
spec_name string 颜色 规格组名称
valueList array - 规格值列表
data.detail.goods_images.specList.valueList 参数
参数名 类型 示例值 说明
spec_value_id int 10001 规格值ID
spec_value string 流沙金 规格值内容
data.detail.goods_images.specList.skuList 参数
参数名 类型 示例值 说明
id int 10198 SKUID
goods_sku_id string 10001_10005 商品SKU唯一标识
goods_id int 10006 商品ID
image_id int - SKU图片ID
goods_sku_no string - SKU编码
goods_price string 734.02 商品价格(实际售价)
line_price string 0.00 划线价格
stock_num int 250 库存数量
goods_weight number 0.15 商品重量
goods_props array - SKU规格属性名称
spec_value_ids array - SKU规格值ID集
image_url null null SKU封面图URL
data.detail.goods_images.specList.skuList.goods_props 参数
参数名 类型 示例值 说明
group object - 规格组
value object - 规格值
data.detail.goods_images.specList.skuList.goods_props.group 参数
参数名 类型 示例值 说明
name string 颜色 规格组名称
id int 10001 规格组ID
data.detail.goods_images.specList.skuList.goods_props.group.value 参数
参数名 类型 示例值 说明
name string 流沙金 规格值名称
id int 10001 规格值ID