?

在電商系統開發、數據分析或比價工具等場景中，獲取商品詳情信息是基礎且關鍵的需求。淘寶開放平臺提供了豐富的API接口，其中獲取商品詳情信息是使用頻率極高的接口之一。本文將詳細介紹如何通過淘寶開放平臺提供的API接口獲取商品詳情。

1. 接口概述

淘寶開放平臺的商品詳情API允許開發者通過商品ID（num_iid）查詢商品的詳細信息，包括但不限于：

商品標題

商品主圖、詳情圖

商品類目ID

商品屬性

商品價格

商品庫存

商品描述

店鋪信息

運費信息等

2. 接口調用流程

調用淘寶API獲取商品詳情通常遵循以下步驟：

2.1 申請成為淘寶開放平臺開發者

訪問淘寶開放平臺官網（open.taobao.com），注冊賬號并完成開發者認證。

2.2 創建應用

登錄開放平臺控制臺，創建一個新應用。創建過程中，需要為應用選擇合適的權限，獲取商品詳情通常屬于商品類API權限。

2.3 獲取API調用憑證

應用創建成功后，系統會分配一對密鑰：

App Key：應用的唯一標識。

App Secret：用于簽名驗證的密鑰，務必保密。 同時，你需要獲取Access Token（訪問令牌），這通常需要通過OAuth2.0授權流程獲得。

2.4 調用商品詳情API

準備好以下信息后，即可發起API請求：

API地址：通常是 https://eco.taobao.com/router/rest。

API方法名：例如 taobao.item.get。

請求參數：必須包含app_key、access_token、sign（簽名）、timestamp（時間戳）、v（API版本號）等公共參數，以及業務參數num_iid（商品ID）。

簽名：根據請求參數和App Secret，按照淘寶指定的簽名算法（如HMAC-SHA256）生成簽名串sign，用于驗證請求的合法性。

3. 核心參數說明

num_iid: 要查詢的淘寶商品ID。這是一個必需的業務參數。例如：1234567890。

fields: 可選參數。指定需要返回的商品信息字段，多個字段用逗號分隔。如果不指定，默認返回所有基礎字段。例如：title,price,pic_url 表示只獲取標題、價格和主圖鏈接。

4. 請求示例

以下是一個Python代碼示例（使用requests庫），展示如何構造請求（注意：App Secret 和 Access Token 需要替換為你的實際值）：

import hashlib
import hmac
import time
import requests

def get_taobao_item_detail(num_iid, app_key, app_secret, access_token):
    # 1. 公共參數
    timestamp = str(int(time.time() * 1000))  # 毫秒時間戳
    method = 'taobao.item.get'  # API方法名
    v = '2.0'  # API版本
    format = 'json'  # 響應格式

    # 2. 業務參數
    params = {
        'method': method,
        'app_key': app_key,
        'timestamp': timestamp,
        'v': v,
        'format': format,
        'sign_method': 'hmac-sha256',
        'access_token': access_token,
        'num_iid': num_iid,
        'fields': 'title,price,pic_url,desc'  # 按需選擇字段
    }

    # 3. 參數排序并拼接
    sorted_params = sorted(params.items(), key=lambda x: x[0])
    param_str = app_secret
    for key, value in sorted_params:
        param_str += key + value
    param_str += app_secret

    # 4. 計算簽名 (HMAC-SHA256)
    sign = hmac.new(app_secret.encode('utf-8'), param_str.encode('utf-8'), hashlib.sha256).hexdigest().upper()
    params['sign'] = sign

    # 5. 發送請求
    response = requests.get('https://eco.taobao.com/router/rest', params=params)
    return response.json()

# 使用示例
app_key = 'YOUR_APP_KEY'
app_secret = 'YOUR_APP_SECRET'  # 注意安全保管
access_token = 'YOUR_ACCESS_TOKEN'
num_iid = '1234567890'  # 目標商品ID

result = get_taobao_item_detail(num_iid, app_key, app_secret, access_token)
print(result)

5. 響應解析

成功的API調用將返回一個JSON對象。核心數據結構通常包含在response下的item對象中。例如：

{
  "item_get_response": {
    "item": {
      "title": "【官方正品】XX品牌 新款智能手機 全網通5G",
      "price": "2999.00",
      "pic_url": "https://img.alicdn.com/.../main.jpg",
      "desc": "這里是商品描述詳情頁的HTML內容..."
      // ... 其他請求的字段
    }
  }
}

你需要根據業務需求解析這個JSON結構中的具體字段值。注意desc字段通常是HTML格式的商品詳情描述。

6. 注意事項

權限與頻率限制：確保你的應用已申請并獲得了調用商品詳情API的權限。淘寶API有嚴格的調用頻率限制（QPS），超出限制會導致調用失敗。

安全：App Secret 是核心機密，切勿泄露或在客戶端代碼中硬編碼。

商品ID有效性：確保傳入的num_iid是有效的淘寶商品ID。

錯誤處理：API響應中可能包含錯誤碼（如error_code和error_msg），需要做好異常捕獲和處理。常見錯誤如無效令牌、參數缺失、頻率超限等。

數據更新：商品詳情（如價格、庫存）可能會頻繁變動，注意數據的時效性。

7. 總結

通過淘寶開放平臺的taobao.item.get接口，開發者可以高效、規范地獲取淘寶商品的詳細信息。關鍵在于正確理解API調用流程、簽名機制以及參數傳遞方式。在實際應用中，務必遵守淘寶開放平臺的規則，合理使用API資源。

?
審核編輯 黃宇