?

本文旨在介紹淘寶天貓平臺的上貨API接口，幫助開發者實現自動化商品上架功能。內容基于公開API文檔和常見實踐，確保真實可靠。我們將逐步解析API的工作原理、使用步驟和代碼實現，助您高效集成。

1. 什么是淘寶天貓上貨API接口？

淘寶天貓上貨API接口是平臺提供的RESTful服務，允許商家通過程序化方式上傳商品信息到店鋪。它基于HTTP協議，支持商品創建、編輯和發布等操作。使用該接口可大幅提升上架效率，尤其適合批量處理場景。例如，一個商品對象包含字段如標題$title$、價格$price$和庫存$quantity$，這些數據通過API傳輸。

2. API工作流程與核心組件

上貨API的核心流程包括認證、請求構建和響應處理。以下是關鍵步驟：

認證機制：需提前申請API密鑰（APP_KEY和APP_SECRET），并使用OAuth 2.0授權獲取訪問令牌$token$。

請求結構：API端點通常為https://api.taobao.com/router/rest，請求方法為POST。參數包括：

method: 指定API方法，如taobao.item.add用于添加商品。

timestamp: 當前時間戳$t$，確保請求時效性。

sign: 基于參數生成的簽名$s$，計算公式為：
$$ s = text{md5}( text{APP_SECRET} + text{sorted_params} + text{APP_SECRET} ) $$
其中，$text{sorted_params}$是將所有參數按字母序拼接的字符串。

響應格式：返回JSON數據，包含狀態碼$code$（如0表示成功）、商品ID$num_iid$等。

3. 如何使用：Python代碼示例

以下是一個完整的Python示例，演示如何調用商品添加接口。假設已安裝requests庫。

import requests
import time
import hashlib

def upload_product(api_key, secret_key, session_key, product_data):
    # API基礎URL
    url = "https://api.taobao.com/router/rest"
    
    # 構建請求參數
    params = {
        "method": "taobao.item.add",
        "app_key": api_key,
        "session": session_key,
        "timestamp": str(int(time.time())),
        "format": "json",
        "v": "2.0",
        "sign_method": "md5",
        "title": product_data["title"],
        "price": str(product_data["price"]),  # 商品價格
        "num": str(product_data["quantity"]),  # 庫存數量
        # 其他可選參數，如描述、類目等
    }
    
    # 生成簽名：按參數名排序后拼接并計算MD5
    sorted_params = "".join(sorted([f"{k}{v}" for k, v in params.items()]))
    sign_str = secret_key + sorted_params + secret_key
    params["sign"] = hashlib.md5(sign_str.encode()).hexdigest()
    
    # 發送POST請求
    response = requests.post(url, data=params)
    result = response.json()
    
    # 處理響應
    if "error_response" in result:
        error_code = result["error_response"]["code"]
        return f"上傳失敗，錯誤碼: {error_code}"
    else:
        item_id = result["item_add_response"]["item"]["num_iid"]
        return f"商品上傳成功，ID: {item_id}"

# 示例調用
if __name__ == "__main__":
    # 替換為您的實際密鑰和數據
    api_key = "YOUR_APP_KEY"
    secret_key = "YOUR_SECRET_KEY"
    session_key = "YOUR_SESSION_TOKEN"  # 從OAuth獲取
    product_info = {
        "title": "新款智能手機",
        "price": 2999.00,  # 價格變量 $price$
        "quantity": 100    # 庫存變量 $quantity$
    }
    
    result = upload_product(api_key, secret_key, session_key, product_info)
    print(result)

4. 注意事項與最佳實踐

速率限制：API有調用頻率限制（如每分鐘100次），超出會返回錯誤碼$429$。建議使用隊列或延時策略。

數據驗證：確保商品數據合法，例如價格$price > 0$，避免因格式錯誤導致失敗。

錯誤處理：常見錯誤包括：

invalid_session: 令牌過期，需刷新$token$。

missing_parameter: 缺少必要參數，檢查請求體。

安全建議：勿泄露APP_SECRET；使用HTTPS加密傳輸。

通過本文，您可快速上手淘寶天貓上貨API接口。如需更詳細文檔，請參考淘寶開放平臺官網。實踐中遇到問題，歡迎在評論區討論！

?審核編輯 黃宇