简要描述
请求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 |