做電商商品系統(tǒng)開(kāi)發(fā)時(shí)，最頭疼的莫過(guò)于 SKU 信息拆解得又雜又亂 —— 圖片對(duì)應(yīng)不上規(guī)格、價(jià)格和屬性對(duì)不上 SKU，折騰半天還容易出錯(cuò)。其實(shí)淘寶開(kāi)放平臺(tái)的item_get_pro接口早就幫我們解決了這個(gè)問(wèn)題，不用復(fù)雜處理就能拉全 SKU 核心數(shù)據(jù)，今天把實(shí)戰(zhàn)細(xì)節(jié)拆給大家。

一、SKU 核心信息怎么拿？字段對(duì)應(yīng)超直觀

1. SKU 圖片：精準(zhǔn)匹配規(guī)格

想獲取每個(gè) SKU 的專(zhuān)屬圖片，直接讀prop_imgs下的prop_img數(shù)組就行。每個(gè)元素都包含properties（屬性編碼，比如 “1627207:1347647754”）和url（圖片鏈接），前端展示時(shí)按屬性編碼關(guān)聯(lián)，就不會(huì)出現(xiàn) “圖不對(duì)版” 的問(wèn)題。示例字段片段：

json

"prop_imgs": {
  "prop_img": [
    {"properties": "1627207:1347647754", "url": "http://img.alicdn.com/imgextra/i3/2596264565/TB2.XeblVXXXXXkXpXXXXXXXXXX_!!2596264565.jpg"},
    {"properties": "1627207:1347647753", "url": "http://img.alicdn.com/imgextra/i4/2596264565/TB2dTrjdVXXXXXBXpXXXXXXXXXX_!!2596264565.jpg"}
  ]
}

2. SKU 文字描述：不用手動(dòng)拼接

SKU 的規(guī)格文字（比如 “長(zhǎng)方形帶開(kāi)瓶器 + 送工具刀卡 + 鏈子”）藏在兩個(gè)地方：

?全局規(guī)格看props_name：一次性獲取所有 SKU 的屬性描述，用分號(hào)分隔；

?單個(gè) SKU 看skus/sku/properties_name：每個(gè) SKU 單獨(dú)的文字說(shuō)明，適合精準(zhǔn)展示。

3. SKU 價(jià)格：多規(guī)格定價(jià)清晰

不同 SKU 的價(jià)格差異，直接從skus/sku數(shù)組里讀：

?price：當(dāng)前售價(jià)（比如 “25.8”“39”）；

?orginal_price：原價(jià)；

?quantity：對(duì)應(yīng) SKU 的庫(kù)存數(shù)量，還能提前判斷是否缺貨。

4. 產(chǎn)品規(guī)格 & 屬性：基礎(chǔ)信息全覆蓋

?基礎(chǔ)屬性：props數(shù)組包含品牌、產(chǎn)地、貨號(hào)等關(guān)鍵信息，比如 “品牌：三刃木”“貨號(hào)：GJ019C”，直接按 “name-value” 鍵值對(duì)提??；

?屬性映射：props_list字段幫你把屬性編碼轉(zhuǎn)成文字（比如 “1627207:1347647754”→“顏色分類(lèi)：長(zhǎng)方形帶開(kāi)瓶器 + 送工具刀卡 + 鏈子”），避免解析混亂。

二、3 個(gè)實(shí)戰(zhàn)小技巧，接口調(diào)用更穩(wěn)

1.加緩存減壓力：對(duì)高頻訪(fǎng)問(wèn)的商品（比如首頁(yè)推薦款），把 SKU 數(shù)據(jù)存到本地緩存（比如 Redis），設(shè)置 1 小時(shí)過(guò)期，能大幅減少接口調(diào)用次數(shù)，避免配額不夠用；

2.錯(cuò)誤重試防限流：遇到 “網(wǎng)絡(luò)超時(shí)” 或 “QPS 超限”，別直接拋錯(cuò) —— 加個(gè)重試機(jī)制（比如間隔 3 秒重試 2 次），重試前先檢查請(qǐng)求參數(shù)是否正確（比如num_iid有沒(méi)有傳錯(cuò)）；

3.數(shù)據(jù)校驗(yàn)保完整：接口返回后，先檢查error_code是否為 “0000”，再確認(rèn)skus/sku和prop_imgs是否有數(shù)據(jù)，避免空值導(dǎo)致前端展示異常。

三、簡(jiǎn)單調(diào)用示例：幾行代碼跑通

python

# coding:utf-8
import requests
def get_taobao_sku_info(app_key, app_secret, num_iid):
    """
    調(diào)用item_get_pro接口獲取SKU信息
    :param app_key: 淘寶開(kāi)放平臺(tái)申請(qǐng)的Key
    :param app_secret: 對(duì)應(yīng)Secret
    :param num_iid: 商品ID（從商品詳情頁(yè)URL獲?。?    """
    # 官方接口請(qǐng)求地址（需替換為開(kāi)放平臺(tái)正式域名）
    url = f"https://api.taobao.com/router/rest?key={app_key}&secret={app_secret}&num_iid={num_iid}&api_name=item_get_pro"
    headers = {"Accept-Encoding": "gzip", "Connection": "close"}
    
    try:
        response = requests.get(url, headers=headers, timeout=(5, 15))
        result = response.json()
        if result.get("error_code") == "0000":
            # 提取SKU核心數(shù)據(jù)
            sku_list = result["item"]["skus"]["sku"]
            prop_imgs = result["item"]["prop_imgs"]["prop_img"]
            print(f"獲取到{len(sku_list)}個(gè)SKU，{len(prop_imgs)}張SKU圖片")
            return {"sku_list": sku_list, "prop_imgs": prop_imgs}
        else:
            print(f"接口調(diào)用失?。簕result.get('reason', '未知錯(cuò)誤')}")
            return None
    except Exception as e:
        print(f"請(qǐng)求異常：{str(e)}")
        return None
# 調(diào)用示例（需替換為自己的Key/Secret和商品ID）
if __name__ == "__main__":
    get_taobao_sku_info("YOUR_APP_KEY", "YOUR_APP_SECRET", "520813250866")

互動(dòng)交流

如果在接口調(diào)試時(shí)遇到 “SKU 圖片關(guān)聯(lián)不上”“價(jià)格字段解析異?！?，或者想了解批量獲取 SKU 的技巧，評(píng)論區(qū)隨時(shí)說(shuō)具體問(wèn)題～小編看到必回，一起避坑少走彎路！

審核編輯 黃宇