簡要描述
請求url
https://www.商城域名.com/index.php?s=/api/goods/detail
請求方式
是否需授權(quán)登錄
請求header
參數(shù)名 |
類型 |
是否必須 |
示例值 |
說明 |
storeId |
int |
必填 |
10001 |
商城ID |
platform |
string |
必填 |
H5 |
當(dāng)前請求的客戶端(APP、小程序、H5等) |
Access-Token |
string |
選填 |
- |
當(dāng)前登錄用戶的 Token |
請求參數(shù)
參數(shù)名 |
類型 |
是否必須 |
示例值 |
說明 |
goodsId |
int |
必填 |
10001 |
商品ID |
返回示例
{
"status": 200,
"message": "success",
"data": {
"detail": {
"goods_id": 10006,
"goods_name": "小米(MI) 紅米6 流沙金 全網(wǎng)通(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": "巴厘藍(lán)"
},
{
"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": "全網(wǎng)通(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": "全網(wǎng)通(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": "巴厘藍(lán)",
"id": 10002
}
},
{
"group": {
"name": "版本",
"id": 10002
},
"value": {
"name": "全網(wǎng)通(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": "全網(wǎng)通(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": "全網(wǎng)通(3G RAM+32G ROM)",
"id": 10005
}
}
],
"spec_value_ids": [
10004,
10005
],
"image_url": null
}
],
"video": null,
"videoCover": null
}
}
}
返回參數(shù)
參數(shù)名 |
類型 |
示例值 |
說明 |
status |
int |
200 |
請求狀態(tài)(200:請求成功;500:請求錯(cuò)誤/失?。?/td>
|
message |
string |
success |
請求結(jié)果的信息,默認(rèn)為 success |
data |
object |
- |
返回的業(yè)務(wù)數(shù)據(jù) |
data 參數(shù)
參數(shù)名 |
類型 |
示例值 |
說明 |
detail |
object |
- |
商品詳情信息 |
data.detail 參數(shù)
參數(shù)名 |
類型 |
示例值 |
說明 |
goods_id |
int |
10006 |
商品ID |
goods_name |
string |
小米(MI) 紅米6 流沙金... |
商品標(biāo)題/名稱 |
goods_no |
string |
- |
商品編號 |
video_id |
int |
- |
主圖視頻ID |
video_cover_id |
int |
- |
主圖視頻封面ID |
selling_point |
string |
- |
商品賣點(diǎn) |
spec_type |
int |
20 |
商品規(guī)格 (10單規(guī)格 20多規(guī)格) |
goods_price_min |
string |
724.22 |
商品價(jià)格 (最低) |
goods_price_max |
string |
979.02 |
商品價(jià)格 (最高) |
line_price_min |
string |
0.00 |
劃線價(jià)格 (最低) |
line_price_max |
string |
0.00 |
劃線價(jià)格 (最高) |
stock_total |
int |
- |
庫存總量 (包含所有sku) |
content |
string |
- |
詳情頁內(nèi)容 |
delivery_id |
int |
10001 |
配送模板ID |
is_points_gift |
int |
1 |
是否開啟積分贈(zèng)送 (1開啟 0關(guān)閉) |
is_points_discount |
int |
1 |
是否允許使用積分抵扣 (1允許 0不允許) |
is_enable_grade |
int |
1 |
是否開啟會(huì)員折扣 (1開啟 0關(guān)閉) |
is_alone_grade |
int |
- |
會(huì)員折扣設(shè)置 (0默認(rèn)等級折扣 1單獨(dú)設(shè)置折扣) |
alone_grade_equity |
array |
- |
單獨(dú)設(shè)置折扣的配置 |
status |
int |
10 |
商品狀態(tài) (10上架 20下架) |
is_ind_dealer |
int |
- |
是否開啟單獨(dú)分銷 (0關(guān)閉 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 |
- |
顯示銷量 (初始銷量 + 實(shí)際銷量) |
is_user_grade |
boolean |
true |
是否使用會(huì)員等級折扣價(jià)(判斷登錄用戶的會(huì)員等級) |
specList |
array |
- |
商品規(guī)格列表 |
skuList |
array |
- |
商品SKU列表 |
video |
null |
null |
商品主圖視頻信息 |
videoCover |
null |
null |
商品主圖視頻封面信息 |
data.detail.goods_images 參數(shù)
參數(shù)名 |
類型 |
示例值 |
說明 |
file_id |
int |
10073 |
文件ID |
file_type |
int |
10 |
文件類型 (10圖片) |
preview_url |
string |
2018071716364761fab9153.jpg |
圖片預(yù)覽地址 |
data.detail.goods_images.specList 參數(shù)
參數(shù)名 |
類型 |
示例值 |
說明 |
spec_id |
int |
10001 |
規(guī)格組ID |
spec_name |
string |
顏色 |
規(guī)格組名稱 |
valueList |
array |
- |
規(guī)格值列表 |
data.detail.goods_images.specList.valueList 參數(shù)
參數(shù)名 |
類型 |
示例值 |
說明 |
spec_value_id |
int |
10001 |
規(guī)格值ID |
spec_value |
string |
流沙金 |
規(guī)格值內(nèi)容 |
data.detail.goods_images.specList.skuList 參數(shù)
參數(shù)名 |
類型 |
示例值 |
說明 |
id |
int |
10198 |
SKUID |
goods_sku_id |
string |
10001_10005 |
商品SKU唯一標(biāo)識 |
goods_id |
int |
10006 |
商品ID |
image_id |
int |
- |
SKU圖片ID |
goods_sku_no |
string |
- |
SKU編碼 |
goods_price |
string |
734.02 |
商品價(jià)格(實(shí)際售價(jià)) |
line_price |
string |
0.00 |
劃線價(jià)格 |
stock_num |
int |
250 |
庫存數(shù)量 |
goods_weight |
number |
0.15 |
商品重量 |
goods_props |
array |
- |
SKU規(guī)格屬性名稱 |
spec_value_ids |
array |
- |
SKU規(guī)格值ID集 |
image_url |
null |
null |
SKU封面圖URL |
data.detail.goods_images.specList.skuList.goods_props 參數(shù)
參數(shù)名 |
類型 |
示例值 |
說明 |
group |
object |
- |
規(guī)格組 |
value |
object |
- |
規(guī)格值 |
data.detail.goods_images.specList.skuList.goods_props.group 參數(shù)
參數(shù)名 |
類型 |
示例值 |
說明 |
name |
string |
顏色 |
規(guī)格組名稱 |
id |
int |
10001 |
規(guī)格組ID |
data.detail.goods_images.specList.skuList.goods_props.group.value 參數(shù)
參數(shù)名 |
類型 |
示例值 |
說明 |
name |
string |
流沙金 |
規(guī)格值名稱 |
id |
int |
10001 |
規(guī)格值ID |