简要描述
请求url
- https://www.商城域名.com/index.php?s=/api/goods/detail
请求方式
是否需授权登录
请求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 |