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

一、SKU 核心信息怎么拿？字段對應超直觀

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

想獲取每個 SKU 的專屬圖片，直接讀prop_imgs下的prop_img數(shù)組就行。每個元素都包含properties（屬性編碼，比如 “1627207:1347647754”）和url（圖片鏈接），前端展示時按屬性編碼關(guān)聯(lián)，就不會出現(xià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 文字描述：不用手動拼接

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

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

?單個 SKU 看skus/sku/properties_name：每個 SKU 單獨的文字說明，適合精準展示。

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

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

?price：當前售價（比如 “25.8”“39”）；

?orginal_price：原價；

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

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

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

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

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

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

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

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

三、簡單調(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: 淘寶開放平臺申請的Key
    :param app_secret: 對應Secret
    :param num_iid: 商品ID（從商品詳情頁URL獲?。?    """
    # 官方接口請求地址（需替換為開放平臺正式域名）
    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)}個SKU，{len(prop_imgs)}張SKU圖片")
            return {"sku_list": sku_list, "prop_imgs": prop_imgs}
        else:
            print(f"接口調(diào)用失?。簕result.get('reason', '未知錯誤')}")
            return None
    except Exception as e:
        print(f"請求異常：{str(e)}")
        return None
# 調(diào)用示例（需替換為自己的Key/Secret和商品ID）
if __name__ == "__main__":
    get_taobao_sku_info("YOUR_APP_KEY", "YOUR_APP_SECRET", "520813250866")

互動交流

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

審核編輯 黃宇