摘要:本篇我思考了很久到底要不要解析下商品接口開發(fā)的注意點。接口設(shè)計簡述電商系統(tǒng)設(shè)計之中,比較復(fù)雜的接口就論商品詳情的接口了,響應(yīng)參數(shù)特別多,特別雜。
前言
我應(yīng)該是少數(shù)在文章中直接展示接口文檔的人。本篇我思考了很久到底要不要解析下商品接口開發(fā)的注意點。
客戶端開發(fā)與服務(wù)端開發(fā)即是天敵也是兄弟。希望本篇文章讓你們減少爭執(zhí),把“愛”給對方。
接口設(shè)計 簡述電商系統(tǒng)設(shè)計之中,比較復(fù)雜的接口就論商品詳情的接口了,響應(yīng)參數(shù)特別多,特別雜。在開發(fā)獲取商品詳情接口時要遵循以下幾個原則
返回的JSON嵌套數(shù)量要少
方便去查詢到指定的SKU
其他接口相關(guān)規(guī)范
查詢SKU關(guān)于查詢SKU,我讓我的小伙伴是這樣做的,首先拿出規(guī)格和屬性
"選擇顏色": [ { "name": "銀色", "id": 75 } ], "選擇版本": [ { "name": "公開版", "id": 77 }, { "name": "【原廠延保版】", "id": 78 } ], "內(nèi)存": [ { "name": "64G", "id": 82 }, { "name": "256G", "id": 83 } ],
沒錯,你沒有看錯,實際就是將規(guī)格作為key,屬性作為value。將value[id]取出,進行拼接即可查詢到對應(yīng)的SKU了。
響應(yīng)參數(shù)[規(guī)格名稱][屬性編碼] = 拼接SKU串的必需品
規(guī)格相當于一個分組,屬性其實也是拼接SKU的重要組成部分,上述數(shù)據(jù)為例
75_77_82 = 銀色,公開版,64G接口文檔 請求地址
/v1/product/{productId}
請求類型GET
請求參數(shù)參數(shù) | 類型 | 默認值 | 說明 |
---|---|---|---|
productId | int | 0 | 商品編碼 |
{ "code": 200, "message": "獲取成功", "data": { "id": 131, "name": "Apple iPhone X (A1865) 64GB 深空灰色 移動聯(lián)通電信4G手機", "price": "8388.00", "market_price": "8388.00", "sketch": "IPhone大法好,打九折,打九折,快剁手", "intro": "這是商品描述", "keywords":["蘋果","iphone"], "attribute": { "選擇顏色": [ { "name": "銀色", "id": 75 }, { "name": "深空灰色", "id": 76 } ], "選擇版本": [ { "name": "公開版", "id": 77 }, { "name": "【原廠延保版】", "id": 78 }, { "name": "雙網(wǎng)通版", "id": 79 }, { "name": "無線充套裝", "id": 80 }, { "name": "Airpods套裝", "id": 81 } ], "內(nèi)存": [ { "name": "64G", "id": 82 }, { "name": "256G", "id": 83 } ], "購買方式": [ { "name": "官方標配", "id": 84 }, { "name": "移動優(yōu)惠購", "id": 85 }, { "name": "電信優(yōu)惠購", "id": 86 }, { "name": "聯(lián)通優(yōu)惠購", "id": 87 } ] }, "album": [ { "id": 2, "name": "這是第一張圖片", "url": "http://xxx.com/59ec33eaN6ddb0c54.jpg" }, { "id": 3, "name": "這是第二張圖片", "url": "http://xxx.com/59ec3400Nce4cc116.jpg" } ], "radio": { "id": 1, "name": "這是一個視頻", "url": "http://xxx.com/1.mp4" }, "sku": { "75_77_82_84": { "id": 1018, "name": "選擇顏色:銀色;選擇版本:公開版;內(nèi)存:64G;購買方式:官方標配;", "price": "8388.00", "stock": 83888388 }, "75_77_82_85": { "id": 1019, "name": "選擇顏色:銀色;選擇版本:公開版;內(nèi)存:64G;購買方式:移動優(yōu)惠購;", "price": "8388.00", "stock": 83888388 }, "75_77_82_86": { "id": 1020, "name": "選擇顏色:銀色;選擇版本:公開版;內(nèi)存:64G;購買方式:電信優(yōu)惠購;", "price": "8388.00", "stock": 83888388 }, "75_77_82_87": { "id": 1021, "name": "選擇顏色:銀色;選擇版本:公開版;內(nèi)存:64G;購買方式:聯(lián)通優(yōu)惠購;", "price": "8388.00", "stock": 83888388 }, "75_77_83_84": { "id": 1022, "name": "選擇顏色:銀色;選擇版本:公開版;內(nèi)存:256G;購買方式:官方標配;", "price": "8388.00", "stock": 83888388 }, "75_77_83_85": { "id": 1023, "name": "選擇顏色:銀色;選擇版本:公開版;內(nèi)存:256G;購買方式:移動優(yōu)惠購;", "price": "8388.00", "stock": 83888388 } } } }響應(yīng)參數(shù)說明 核心參數(shù)
參數(shù) | 類型 | 默認值 | 說明 |
---|---|---|---|
id | int | 0 | 商品編碼 |
name | string | - | 商品標題 |
price | double | 00.00 | 商品價格 |
keywords | string | - | 商品關(guān)鍵字 |
market_price | double | 00.00 | 市場價格 |
virtual | int | 0 | 虛擬銷量 |
sketch | string | - | 商品簡述 |
intro | string | - | 商品詳情 |
參數(shù) | 類型 | 默認值 | 說明 |
---|---|---|---|
album[] | array | [] | 商品輪播圖 |
id | int | 0 | 資源編碼 |
name | string | - | 圖片名稱 |
url | string | - | 資源路徑 |
無視頻則返回 []
參數(shù) | 類型 | 默認值 | 說明 |
---|---|---|---|
radio[] | array | [] | 商品視頻 |
id | int | 0 | 資源編碼 |
name | string | - | 視頻名稱 |
url | string | - | 資源路徑 |
參數(shù) | 類型 | 默認值 | 說明 |
---|---|---|---|
attribute | array[] | [] | 商品屬性 |
[(attr_name)] [] | array[] | [] | 屬性名稱 |
name | string | - | 屬性項名稱 |
id | int | 0 | 屬性項編碼 |
參數(shù) | 類型 | 默認值 | 說明 |
---|---|---|---|
sku[] | array[] | [] | 商品sku |
[(option_id)] [] | array[] | 商品SKU查詢辦法為 attribute(attr_name) 拼接 | |
id | int | 0 | sku編碼 |
name | string | - | sku 名稱 |
price | double | 00.00 | 商品價格 |
stock | int | 0 | 商品庫存 |
字不在多,講清楚就行,感謝你看到這里,希望本篇文章可以幫助到你,有疑問可以在評論區(qū)討論,謝謝。
文章版權(quán)歸作者所有,未經(jīng)允許請勿轉(zhuǎn)載,若此文章存在違規(guī)行為,您可以聯(lián)系管理員刪除。
轉(zhuǎn)載請注明本文地址:http://specialneedsforspecialkids.com/yun/29156.html
摘要:前言這是電商系統(tǒng)設(shè)計系列在商品設(shè)計這塊的最后一篇文章。電商系統(tǒng)商品相關(guān)的文章已經(jīng)到了尾聲如果有其他商品相關(guān)的文章需要編寫可以私信聯(lián)系我畢竟我也是公司員工寫這些文章并不是我的工作,只是記錄我的職業(yè)生涯。 showImg(https://segmentfault.com/img/bVbePdh?w=1260&h=628); 前言 這是電商系統(tǒng)設(shè)計系列在商品設(shè)計這塊的最后一篇文章。以下是其他...
摘要:商品詳情接口商品表按索引查詢商品信息。接著,我們來看看和定義名稱概念解釋標準產(chǎn)品單位剝離銷售屬性的部分,例如小米。 前言 建議使用大屏設(shè)備(例如pad/pc),可以更好的瀏覽本篇文章 今天我們開始「商品系統(tǒng)」的篇章。本文分為如下五大模塊: 需求分析 架構(gòu)設(shè)計 Spu和Sku的故事 數(shù)據(jù)模型設(shè)計 接口設(shè)計 第一篇我們主要看看一個入門的電商平臺(B2C)如何去構(gòu)建自己的基礎(chǔ)商品信息,其...
摘要:訂單號用戶商品標題商品價格商品封面圖商品其他屬性小明愛瘋手機其他屬性像上表中設(shè)計,有人會問了那關(guān)聯(lián)的意義何在呢我的回答是保持數(shù)據(jù)關(guān)聯(lián),雖然商戶有可能改變商品屬性,但作為一名程序員,應(yīng)該盡可能的記錄用戶所有的動作。 showImg(https://segmentfault.com/img/bVbdtuc?w=1824&h=1028); 電商大伙每天都在用,類似某貓,某狗等。電商系統(tǒng)設(shè)計看...
摘要:可擴展性百度百科的定義是設(shè)計良好的代碼允許更多的功能在必要時可以被插入到適當?shù)奈恢弥小UY徫镘嚿唐穬?yōu)惠券都是獨立的系統(tǒng)及功能,不要看做商品在購物車內(nèi)。可維護性百度百科的定義是系統(tǒng)的可維護性是衡量一個系統(tǒng)的可修復(fù)恢復(fù)性和可改進性的難易程度。 showImg(https://segmentfault.com/img/bVbcqJE?w=506&h=326); 本章適合初級工程師及中級工程...
摘要:我一直在說電商是一個既簡單又復(fù)雜的東西本章我們再一次深度解析電商系統(tǒng)商品設(shè)計的更多邏輯與實現(xiàn)。品牌無需關(guān)聯(lián)到內(nèi),道理很簡單,當前的是歸屬與蘋果公司,自然而然下面的規(guī)格都屬于蘋果了。 showImg(https://segmentfault.com/img/bVbdtuc?w=1824&h=1028); 電商大伙每天都在用,類似某貓,某狗等。電商系統(tǒng)設(shè)計看似復(fù)雜又很簡單,看似簡單又很復(fù)雜...
閱讀 3871·2021-07-28 18:10
閱讀 2580·2019-08-30 15:44
閱讀 1087·2019-08-30 14:07
閱讀 3464·2019-08-29 17:20
閱讀 1579·2019-08-26 18:35
閱讀 3538·2019-08-26 13:42
閱讀 1820·2019-08-26 11:58
閱讀 1592·2019-08-23 18:33