一、接口概述

淘寶開(kāi)放平臺(tái)提供的 taobao.item.get 接口，用于獲取單個(gè)商品的詳細(xì)信息。通過(guò)此接口，開(kāi)發(fā)者可以獲取商品的基礎(chǔ)信息、庫(kù)存規(guī)格、營(yíng)銷信息等。

接口地址

• HTTPS GET：https://eco.taobao.com/router/rest

核心參數(shù)

二、簽名生成

淘寶 API 采用 MD5 簽名機(jī)制，確保請(qǐng)求安全。簽名生成步驟如下：

1. 參數(shù)排序：除 sign 外所有參數(shù)按字典序排序。
2. 拼接字符串：參數(shù)名 + 參數(shù)值拼接，首尾加 App Secret。
3. MD5 加密：對(duì)拼接字符串進(jìn)行 32 位大寫 MD5 加密。

Python 簽名示例

import hashlib

def generate_sign(params, app_secret):
    sorted_params = sorted(params.items(), key=lambda x: x[0])
    sign_str = app_secret + ''.join([f"{k}{v}" for k, v in sorted_params]) + app_secret
    return hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()
    

三、調(diào)用示例

以下是一個(gè)完整的 Python 調(diào)用示例，展示如何使用 taobao.item.get 接口獲取商品詳情。

1. 準(zhǔn)備工作

• 安裝 requests 庫(kù)，用于發(fā)送 HTTP 請(qǐng)求。bash復(fù)制pip install requests

2. 完整代碼示例

import requests
import hashlib
import time

def generate_sign(params, app_secret):
    sorted_params = sorted(params.items(), key=lambda x: x[0])
    sign_str = app_secret + ''.join([f"{k}{v}" for k, v in sorted_params]) + app_secret
    return hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()

def get_item_details(app_key, app_secret, num_iid):
    url = "https://eco.taobao.com/router/rest"
    timestamp = time.strftime("%Y-%m-%d %H:%M:%S", time.localtime())
    params = {
        "method": "taobao.item.get",
        "app_key": app_key,
        "timestamp": timestamp,
        "format": "json",
        "v": "2.0",
        "sign_method": "md5",
        "num_iid": num_iid,
        "fields": "num_iid,title,price,pic_url,desc,skus,stock,promotion_price,activity_tag,ai_tag"
    }
    params["sign"] = generate_sign(params, app_secret)
    response = requests.get(url, params=params)
    data = response.json()
    if "item_get_response" in data:
        return data["item_get_response"]["item"]
    else:
        print("Error:", data.get("error_response", {}).get("msg", "未知錯(cuò)誤"))
        return None

# 示例調(diào)用
app_key = "YOUR_APP_KEY"
app_secret = "YOUR_APP_SECRET"
num_iid = "652874751412"
item_info = get_item_details(app_key, app_secret, num_iid)
if item_info:
    print("商品標(biāo)題:", item_info["title"])
    print("價(jià)格:", item_info["price"])
    print("主圖鏈接:", item_info["pic_url"])
    print("SKU信息:", item_info.get("skus", []))
    

3. 響應(yīng)示例

成功調(diào)用接口后，返回的 JSON 數(shù)據(jù)示例如下：

{
  "item_get_response": {
    "item": {
      "num_iid": "652874751412",
      "title": "示例商品",
      "price": "99.00",
      "pic_url": "https://example.com/image.jpg",
      "desc": "商品詳細(xì)描述...",
      "skus": [
        {
          "sku_id": "123456789",
          "price": "99.00",
          "quantity": 100,
          "properties": "顏色:紅色;尺碼:M"
        }
      ],
      "stock": 100,
      "promotion_price": "89.00",
      "activity_tag": "限時(shí)折扣",
      "ai_tag": "網(wǎng)紅爆款"
    }
  }
}

四、字段選擇策略

2025 年，taobao.item.get 接口新增了 AI 智能標(biāo)簽等字段，合理選擇 fields 參數(shù)可以提升效率。以下是一些核心字段及其適用場(chǎng)景：

五、最佳實(shí)踐與注意事項(xiàng)

1. 調(diào)用頻率控制

• 免費(fèi)版 API 有調(diào)用頻率限制（通常為 500 次/天）。
• 商業(yè)版可申請(qǐng)更高調(diào)用配額。

2. 數(shù)據(jù)緩存策略

• 對(duì)不常變的數(shù)據(jù)（如商品標(biāo)題、圖片）進(jìn)行本地緩存。
• 對(duì)價(jià)格、庫(kù)存等實(shí)時(shí)性要求高的數(shù)據(jù)設(shè)置較短緩存時(shí)間。

3. 異常處理建議

• 網(wǎng)絡(luò)異常重試機(jī)制。
• 接口限流處理。
• 錯(cuò)誤日志記錄。

4. 安全注意事項(xiàng)

• 妥善保管 App Secret。
• 使用 HTTPS 協(xié)議傳輸。
• 對(duì)用戶輸入的 item_id 進(jìn)行合法性校驗(yàn)。
• 通過(guò)本文的介紹和代碼示例，開(kāi)發(fā)者可以快速掌握淘寶商品詳情接口的調(diào)用方法，在實(shí)際項(xiàng)目中集成淘寶商品數(shù)據(jù)。根據(jù)業(yè)務(wù)需求，可以進(jìn)一步擴(kuò)展功能，如商品搜索、訂單同步等。

如遇任何疑問(wèn)或有進(jìn)一步的需求，請(qǐng)隨時(shí)與我私信或者評(píng)論聯(lián)系。