# 商品詳情
>[danger]接口認證:**需要認證**
##### 響應說明
| 字段名 | 字段類型 | 字段說明 |
| --- | --- | --- |
| id | int | 商品id |
| goods_name | string | 商品名 |
| click_count | int | 點擊數 |
| goods_image | string | 商品主圖 |
| pay_type | int | 付款方式,0:現金支付,當前只有0 |
| cash_rate | float | 現金比例(%) |
| shipping_price | int | 郵費(分) |
| lucy_score | int | 幸運積分 |
| activity_type | int | 商品活動類型,另外列出 |
| stock_number | int | 庫存 |
| sales | int | 銷量 |
| unpublished_at | string(datetime) | 下架時間,未設置為“”,設置后為“2022-01-01 00:00:00” |
| is_recommend | int | 是否推薦,1:是,0:否 |
| created_at | string(datetime) | 創建時間 |
| shipping_price_format | string | 郵費價(已格式化) |
| send_province_name | string | 發貨省 |
| send_city_name | string | 發貨市 |
| goods_ext | object | 商品額外信息 |
| goods_ext.desc | string | 描述 |
| goods_ext.contant | string | 詳情內容 |
| goods_ext.slide_images | array[string] | 輪播圖 |
| goods_skus | object | 商品規格細則 |
| goods_skus.sku_id | string | 規格的id串 |
| goods_skus.sku_name | string | 規格的名字串 |
| goods_skus.sku_full_name | string | 已組合好的商品名 規格名,也可以自己組 |
| goods_skus.shop_price | int | 本店價(分) |
| goods_skus.shop_price_format | string | 本店價(已格式化) |
| goods_skus.group_price | int | 團購價(分) |
| goods_skus.group_price_format | string | 團購價(已格式化) |
| goods_skus.market_price | int | 市場價(分) |
| goods_skus.market_price_format | string | 市場價(已格式化) |
| goods_skus.sales | int | 銷量 |
| goods_skus.stock_number | int | 庫存 |
| goods_skus.withdrawal_score | int | 消耗配額 |
| goods_skus.goods_sku_ref_id | int | 商品的規格id,下單時用這個id下單不要用商品id下單 |
| goods_skus.activity_info.activity_score_rate | float | 收益積分(批發積分)(%) |
| goods_skus.activity_info.withdrawal_quota_rate | float | 收益積分(提現配額)(%) |
| goods_skus.activity_info.activity_score_format | float | 贈送批發積分 |
| goods_skus.activity_info.withdrawal_quota_format | float | 贈送提現配額 |
| goods_skus.activity_info.wholesale_limit | int | 批發限購 |
| goods_skus.activity_info.group_buying_limit| int | 團購限購 |
| goods_skus.activity_info.group_buying_scale| int | 團購參團人數 |
| goods_skus.activity_info.gold_vip_score| int | 養老積分抵扣 |
| goods_skus.group_buy_info |array[object]|團購信息|
| goods_skus.group_buy_info.group_buying_start |string|團購開始時間|
| goods_skus.group_buy_info.group_buying_countdown|int|團購倒計時(分)|
| goods_skus.group_buy_info.group_buying_count|int|當前參團人數|
| goods_skus.group_buy_info.group_buying_scale|int|成團人數|
| goods_skus.group_buy_info.group_buying_left|int|剩余成團人數|
| goods_skus.group_buy_info.group_buying_id|int|拼團id|
| goods_skus.group_buy_info.goods_sku_id|int|商品規格id|
| goods_skus.group_buy_info.group_buying_time_left|int|剩余成團時間(秒)|
| goods_skus.group_buy_info.group_buying_user_list|array[object]|當前拼團用戶列表|
| goods_skus.group_buy_info.group_buying_user_list.user_id|int|用戶id|
| goods_skus.group_buy_info.group_buying_user_list.avatar|string|用戶頭像|
| goods_attrs | array[object] | 商品屬性 |
| goods_attrs.name | string | 屬性名 |
| goods_attrs.value | string | 屬性值 |
| activity_info | object | 活動信息 |
| sku_list | array[object] | 規格選項信息 |
| sku_list.sku_group_name | string | 規格大類名字 |
| sku_list.sku_list | array[object] | 規格大類的選項 |
| sku_list.sku_list.sku_id | int | 規格的id |
| sku_list.sku_list.sku_name | string | 規格的名字 |
##### 商品活動類型
```php
public const ACTIVITY_TYPE_TRANS = [
0 => "普通",
1 => '活動',
2 => '批發',
3 => '團購',
4 => '黃金會員專區',
5 => '提現配額專區',
6 => '0元體驗',
];
```
##### api說明
~~~[api]
get:/goods/detail?id=30
*int:id=30#商品id
<<<
success
{
"code": 200,
"msg": "成功",
"data": {
"id": 29,
"goods_name": "團購-衣服-規格",
"click_count": 4,
"goods_image": "http://noobcoder.oss-cn-hangzhou.aliyuncs.com/letao/20220112/goods_image-61de3872655d3.jpg",
"pay_type": 0,
"cash_rate": "100",
"shipping_price": 0,
"lucy_score": 0,
"activity_type": 3,
"stock_number": 80,
"sales": 0,
"unpublished_at": "",
"is_recommend": 1,
"created_at": "2022-01-12 10:09:58",
"goods_ext": {
"desc": "",
"content": "",
"slide_images": [
"http://noobcoder.oss-cn-hangzhou.aliyuncs.com/letao/20220112/goodsExt.slide_images-61de387470146.jpg"
]
},
"goods_skus": [
{
"sku_id": "",
"sku_name": "",
"sku_full_name": "團購-衣服-規格 ",
"shop_price": 100000,
"group_price": 90000,
"sales": 0,
"stock_number": 80,
"withdrawal_score": 0,
"goods_sku_ref_id": 26,
"shop_price_format": 1000,
"group_price_format": 900,
"market_price": 0,
"market_price_format": 0,
"activity_info": {
"wholesale_limit": 0,
"group_buying_limit": 5,
"group_buying_scale": 2,
"gold_vip_score": 0,
"activity_score_rate": 20,
"withdrawal_quota_rate": 100,
"activity_score_format": 200,
"withdrawal_quota_format": 1000
},
"group_buy_info": [
{
"group_buying_id": 5,
"goods_sku_id": 26,
"group_buying_start": "2022-02-18 16:00:44",
"group_buying_countdown": 1800000,
"group_buying_count": 2,
"group_buying_scale": 2,
"group_buying_left": 0,
"group_buying_time_left": 1543366,
"group_buying_user_list": [
{
"user_id": 20,
"avatar": "http://noobcoder.oss-cn-hangzhou.aliyuncs.com/letao/app/user/updateAvatar/61ef9247d6597.png"
},
{
"user_id": 21,
"avatar": "http://noobcoder.oss-cn-hangzhou.aliyuncs.com/letao/20220120/avatar-61e8f49481d2f.png"
}
]
}
]
}
],
"goods_attrs": [
{
"name": "品牌",
"value": "耐不克"
},
{
"name": "材質",
"value": "純棉"
}
],
"sku_list": [],
"shipping_price_format": 0,
"send_province_name": "天津市",
"send_city_name": "天津市"
}
}
~~~
## 額外說明
1. 請求接口的id和下單的id并不是一個id,請求商品的id`goods_id`是這個商品的集合,下單的商品id`goods_sku_ref_id`是這個商品的某一個單位的id,類似于查看一件衣服的詳情和購買一件紅色L號的衣服的關系
2. 在未設置規格(sku_list為空數組的情況下)應該取出`goods_skus`中的第一個規格提交訂單
3. 在設置了規格的情況下,可以通循環過`goods_skus[]`的方式尋找規格,`goods_skus`中的每一項的屬性名都是由一個或多個`sku_id`組成,規律為先將`sku_id`數組`由小到大排列`,然后用`,,`連接,前后加上`,`,類似于`sku_ids = "," + sku_id_arr.sort()join(',,') + ","`
4. `goods_attrs`是一個商品的屬性列表,參考淘寶等購物軟件中商品詳情中的參數
## 可能出現的錯誤碼
> 不包含常見的請求方式錯誤,參數丟失,用戶權限驗證失敗
~~~
const GOODS_NOT_FOUND = [
'code' => 111001,
'msg' => '商品不存在'
];
~~~
~~~
const GOODS_EMPTY_SKU = [
'code' => 111002,
'msg' => '商品規格信息不存在'
];
~~~
- 樂淘唄唄
- 說明
- 服務器環境
- 接口響應格式規范
- 接口認證
- 刷新token
- 錯誤碼
- 短信
- 發送短信驗證碼
- 驗證短信驗證碼
- 注冊/登錄相關
- 注冊
- 登錄
- 登出
- 修改密碼
- 商品列表
- 主頁獲取隨機商品
- 商品分類商品列表
- 品質生活商品列表
- 限時秒殺(活動專區)
- 0元體驗
- 團購商品列表
- 批發商品(幸運搶批)
- 搜索商品
- 商品通用
- 商品分類
- 商品詳情
- 輪播圖
- 用戶
- 用戶地址
- 用戶地址列表
- 修改默認地址
- 保存地址
- 獲取一個地址
- 獲取默認地址
- 刪除一個地址
- 設置
- 修改頭像
- 修改手機號
- 實名認證
- 獲取實名認證信息
- 保存實名認證信息
- 獲取銀行卡信息
- 保存銀行卡信息
- 修改昵稱
- 修改交易密碼
- 修改密碼
- 獲取用戶信息
- 獲取邀請二維碼
- 訂單
- 檢查訂單是否可以下單
- 計算訂單價格
- 創建訂單
- 獲取訂單支付信息
- 普通訂單列表
- 訂單列表
- 取消訂單
- 訂單詳情
- 物流信息
- 刪除訂單
- 確認收貨
- 寄售訂單列表
- 寄售訂單列表
- 寄售訂單狀態列表
- 查詢訂單狀態
- 用戶前端取消支付組件通知服務端
- 微信支付創建預支付訂單信息
- 其他
- 獲取省市區數據
- 獲取銀行和代碼信息
- 個人中心
- 賬戶余額
- 申請提現
- 批發額度
- 養老積分
- 養老積分釋放(未完成)
- 養老積分轉換提現配額
- 養老積分轉移給其他用戶
- 提現配額
- 我的邀請
- 社群流水
- 系統設置
- 獲取全部系統設置(不推薦)
- 關于我們
- 注冊協議
- 邀請海報設置
- 熱門搜索
- 團購拼團信息
- demo