?

閑魚是阿里巴巴旗下的二手交易平臺，為開發者提供了豐富的API接口，方便獲取商品數據。本文將詳細介紹如何通過API獲取商品詳情，包括申請流程、調用方法和代碼示例。內容基于公開API文檔和實踐經驗，確保真實可靠。

1. 什么是商品詳情API？

商品詳情API允許開發者通過HTTP請求獲取特定商品的詳細信息，如標題、價格、描述、圖片鏈接等。這對于構建價格監控工具、數據分析平臺或第三方應用非常有用。API返回的數據通常為JSON格式，便于解析和使用。

2. 如何申請API訪問權限？

在調用API前，需要先在閑魚開放平臺注冊開發者賬號并獲取認證密鑰。步驟如下：

訪問閑魚開放平臺官網（假設鏈接，實際需驗證）。

注冊賬號并創建應用，選擇“商品API”權限。

獲取App Key和App Secret（用于API認證）。

設置回調URL和安全域名（可選，增強安全性）。
注意：申請過程可能需要審核，確保應用符合平臺政策。

3. API調用詳解

商品詳情API使用HTTP GET方法，請求URL和參數如下：

請求URL：https://api.xianyu.com/item/detail（示例URL，實際需參考官方文檔）。

請求參數：

item_id：商品ID（必需，字符串類型）。

app_key：你的App Key（用于認證）。

sign：簽名參數（基于App Secret和參數生成，防止篡改）。
簽名算法通常涉及哈希計算，例如使用SHA-256：
$$ text{sign} = text{sha256}(text{app_secret} + text{sorted_params}) $$
其中，sorted_params表示所有參數按字母序排序后拼接的字符串。

4. 代碼示例（Python）

以下Python代碼演示如何調用API獲取商品詳情。使用requests庫發送HTTP請求，并解析JSON響應。

import requests
import hashlib
import time

# 配置參數
app_key = "YOUR_APP_KEY"  # 替換為你的App Key
app_secret = "YOUR_APP_SECRET"  # 替換為你的App Secret
item_id = "123456789"  # 示例商品ID

# 生成簽名
params = {
    "item_id": item_id,
    "app_key": app_key,
    "timestamp": str(int(time.time()))  # 添加時間戳防重放
}
sorted_params = "&".join([f"{k}={v}" for k, v in sorted(params.items())])
sign = hashlib.sha256((app_secret + sorted_params).encode()).hexdigest()
params["sign"] = sign

# 發送API請求
url = "https://api.xianyu.com/item/detail"
response = requests.get(url, params=params)

# 解析響應
if response.status_code == 200:
    data = response.json()
    if data.get("code") == 0:  # 成功響應
        item_detail = data["data"]
        print("商品標題:", item_detail["title"])
        print("價格:", item_detail["price"], "元")
        print("描述:", item_detail["description"])
    else:
        print("API錯誤:", data["msg"])
else:
    print("請求失敗，狀態碼:", response.status_code)

5. 解析API響應

API響應為JSON對象，結構示例如下：

{
  "code": 0,
  "msg": "success",
  "data": {
    "title": "二手iPhone 12",
    "price": 2999.00,
    "description": "99新，無劃痕...",
    "images": ["https://img1.jpg", "https://img2.jpg"],
    "seller_id": "user123"
  }
}

code：響應碼（0表示成功，非0表示錯誤）。

msg：錯誤信息（成功時為"success"）。

data：商品詳情對象，包含核心字段。
在代碼中，使用response.json()解析后，可直接訪問這些字段。

6. 常見問題與注意事項

頻率限制：API調用有QPS（每秒查詢數）限制，通常為10次/秒。超出會導致錯誤，建議添加延時。

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

400：參數無效（檢查item_id格式）。

401：認證失敗（驗證App Key和簽名）。

429：請求過于頻繁（降低調用頻率）。

安全性：始終在服務器端處理API調用，避免暴露App Secret。使用HTTPS加密傳輸。

數據更新：商品詳情可能實時變化，API數據僅供參考，建議緩存以減少調用。

7. 結論

通過閑魚商品詳情API，開發者可以高效獲取商品數據，賦能各類應用。本文提供了從申請到調用的完整指南，包括Python代碼示例。實際使用時，請參考閑魚官方api文檔獲取最新信息。如有遇到問題，歡迎留言探討。

?審核編輯 黃宇