?

在電商平臺開發中，調用API獲取商品詳情是常見需求。Shopee（蝦皮）作為主流平臺，提供了開放的API接口，允許開發者根據商品ID（如$item_id$）查詢詳細信息。本文將一步步指導你實現這一過程，包括準備工作、API調用、代碼示例和錯誤處理。內容基于Shopee Open Platform的通用規范，確保真實可靠。

步驟1: 準備工作

在調用API前，你需要完成以下基礎設置：

注冊開發者賬號：訪問Shopee Open Platform官網，注冊賬號并通過審核。

獲取API憑證：登錄開發者中心，創建應用并獲取關鍵參數：

partner_id：你的應用ID。

shop_id：店鋪ID（如果關聯店鋪）。

secret_key：用于生成簽名的密鑰。

環境準備：確保你有編程環境（如Python），并安裝必要的庫（如requests）。

這些憑證是安全調用API的基礎，缺失會導致請求失敗。簽名生成涉及哈希算法（如HMAC-SHA256），公式可表示為$sign = text{hash}(text{secret_key} + text{query_string})$，但實際實現需在代碼中完成。

步驟2: API接口說明

Shopee的獲取商品詳情API使用HTTP GET方法，端點URL通常為：

https://api.shopee.com/v2/item/get

關鍵參數包括：

item_id：商品ID，必須是有效的Shopee商品ID，如$123456789$。

其他必填參數：partner_id, shop_id, timestamp（當前時間戳），和sign（簽名）。

API響應為JSON格式，包含商品詳情字段，如標題、價格、庫存和描述。響應結構示例：

{
  "item": {
    "item_id": 123456789,
    "item_name": "示例商品",
    "price": 100.00,
    "stock": 50,
    "description": "商品詳細描述..."
  }
}

如果參數無效或憑證錯誤，API可能返回錯誤碼（如400 Bad Request）。

步驟3: 請求構建

構建請求時，需生成簽名以確保安全。簽名算法步驟：

將所有參數（除sign外）按字母順序排序。

拼接參數字符串（如item_id=123456789&partner_id=YOUR_PARTNER_ID...）。

使用secret_key對拼接字符串應用HMAC-SHA256哈希，生成簽名sign。

數學上，哈希過程可抽象為： $$ text{sign} = text{HMAC-SHA256}(text{secret_key}, text{sorted_query_string}) $$ 在代碼中實現時，避免手動計算，使用庫函數更可靠。

步驟4: 代碼示例（Python）

以下Python示例演示了完整調用過程。假設你已安裝requests和hmac庫。

import requests
import time
import hmac
import hashlib
import urllib.parse

def get_product_details(item_id, partner_id, shop_id, secret_key):
    # 基礎URL
    api_url = "https://api.shopee.com/v2/item/get"
    
    # 生成時間戳（單位：秒）
    timestamp = str(int(time.time()))
    
    # 構建參數字典
    params = {
        "item_id": item_id,
        "partner_id": partner_id,
        "shop_id": shop_id,
        "timestamp": timestamp
    }
    
    # 排序并拼接參數字符串
    sorted_params = sorted(params.items())
    query_string = "&".join([f"{key}={value}" for key, value in sorted_params])
    
    # 生成簽名：HMAC-SHA256
    sign = hmac.new(
        secret_key.encode('utf-8'),
        query_string.encode('utf-8'),
        hashlib.sha256
    ).hexdigest()
    
    # 添加簽名到參數
    params["sign"] = sign
    
    # 發送GET請求
    response = requests.get(api_url, params=params)
    
    # 檢查響應狀態
    if response.status_code == 200:
        return response.json()  # 返回解析后的JSON數據
    else:
        # 錯誤處理：打印錯誤信息
        error_msg = f"API請求失敗，狀態碼：{response.status_code}, 響應：{response.text}"
        raise Exception(error_msg)

# 示例調用
if __name__ == "__main__":
    # 替換為你的憑證
    item_id = "123456789"  # 商品ID
    partner_id = "YOUR_PARTNER_ID"
    shop_id = "YOUR_SHOP_ID"
    secret_key = "YOUR_SECRET_KEY"
    
    try:
        product_details = get_product_details(item_id, partner_id, shop_id, secret_key)
        print("商品詳情：", product_details)
    except Exception as e:
        print("錯誤：", str(e))

這段代碼：

定義函數get_product_details，接受商品ID和憑證。

生成時間戳和簽名。

發送請求并處理響應。

使用異常處理捕獲錯誤。

步驟5: 響應解析與錯誤處理

成功響應后，解析JSON數據以提取商品信息。常見字段包括：

item_id：商品ID。

item_name：標題。

price：價格（單位：貨幣）。

stock：庫存數量。

錯誤處理建議：

常見錯誤碼：

400：參數無效（如商品ID格式錯誤）。

401：認證失敗（簽名或憑證錯誤）。

404：商品不存在。

調試技巧：

驗證參數：確保$item_id$是數字字符串。

檢查簽名：使用Shopee文檔中的測試工具比對。

重試機制：添加延時重試（如5秒后重試）。

注意事項

頻率限制：Shopee API有調用頻率限制（如每分鐘100次），避免頻繁請求。

數據安全：保密secret_key，不要在客戶端代碼中硬編碼。

版本兼容：API可能更新，定期查看Shopee官方文檔。

測試環境：先在沙盒環境測試，再用于生產。

總結

通過本文，你學會了如何基于Shopee API根據商品ID獲取商品詳情。核心步驟包括注冊開發者、構建請求、生成簽名和處理響應。示例代碼可直接集成到你的項目中。API調用是高效獲取數據的方式，但務必遵循平臺規范以確保穩定性。如有任何疑問，歡迎大家留言探討。

?審核編輯 黃宇