引言在二手交易平臺的數據分析、價格監控或商品信息聚合等應用場景中，通過商品ID（item_id）精準獲取商品的詳細信息是基礎且關鍵的一步。閑魚作為國內領先的C2C二手交易平臺，提供了開放平臺API供開發者使用。本文將介紹如何通過調用閑魚的開放API，根據商品ID獲取商品詳情數據。

核心接口閑魚開放平臺提供了商品相關的API接口，其中獲取商品詳情的主要接口通常是 aliexpress.item.get 或其類似命名的接口（具體接口名稱請以官方最新文檔為準）。其核心功能是根據傳入的商品ID，返回該商品的詳細信息。

接口調用流程

前置條件

擁有有效的閑魚開放平臺開發者賬號。

創建應用（AppKey），獲取 AppKey 和 AppSecret。

了解并遵守閑魚開放平臺的API調用規則、頻率限制和權限要求。

認證與簽名調用閑魚API通常需要進行安全認證。最常見的方式是使用OAuth 2.0協議獲取訪問令牌（access_token），并在請求頭中攜帶。同時，請求參數需要進行簽名（如使用 HMAC-SHA256 算法），以確保請求的完整性和來源可信。簽名過程涉及 AppSecret、時間戳、隨機字符串等參數。

請求參數主要的請求參數包括：

item_id: 要查詢的閑魚商品的唯一標識符。這是必填參數。

access_token: 通過OAuth認證流程獲取的訪問令牌，用于標識調用者身份和權限。放在 Authorization 請求頭中或作為參數傳遞（根據API設計）。

fields: (可選) 指定需要返回的字段列表，用于控制返回數據的粒度，減少不必要的網絡傳輸。例如 title,price,images。

HTTP 請求方法通常使用 GET 方法。

API 地址示例接口地址通常形如：

https://openapi.aliexpress.com/router/rest?method=aliexpress.item.get

（請務必以閑魚開放平臺官方文檔公布的最新地址為準）

響應格式成功調用后，API 會返回一個 JSON 格式的響應體。響應結構通常包含：

code: 狀態碼（例如，200 表示成功）。

message: 狀態信息（如 "success"）。

data: 包含商品詳情數據的對象。

商品詳情數據結構示例 (data 對象內)

{ "item_id": "1234567890", "title": "九成新 iPhone 13 Pro Max", "price": { "amount": 4500.00, "currency": "CNY" }, "images": [ "https://img.alicdn.com/.../image1.jpg", "https://img.alicdn.com/.../image2.jpg" ], "description": "國行，256G，藍色，無拆無修...", "seller_info": { "user_id": "seller123", "nickname": "誠信賣家" }, "location": "北京市朝陽區", "status": "on_sale", // 商品狀態，如 on_sale (在售), sold (已售), removed (下架) "category_id": "123", "sku_info": [...], // SKU信息，如有 // ... 其他可能的字段，如瀏覽量、收藏數、發布時間等 }

Python 調用示例 (偽代碼)

import requests import hashlib import hmac import time import urllib.parse # 替換為你的實際信息 APP_KEY = 'your_app_key' APP_SECRET = 'your_app_secret' ACCESS_TOKEN = 'your_access_token' # 需要通過OAuth流程獲取 ITEM_ID = 'target_item_id' # 1. 基礎參數 method = 'aliexpress.item.get' timestamp = str(int(time.time() * 1000)) # 毫秒時間戳 sign_method = 'sha256' version = '1.0' format = 'json' # 2. 構建公共參數字典 base_params = { 'method': method, 'app_key': APP_KEY, 'sign_method': sign_method, 'timestamp': timestamp, 'v': version, 'format': format, 'access_token': ACCESS_TOKEN } # 3. 添加業務參數 params = base_params.copy() params['item_id'] = ITEM_ID # 可選： params['fields'] = 'title,price,images' # 4. 對參數進行排序并拼接字符串 sorted_keys = sorted(params.keys()) sign_str = APP_SECRET for key in sorted_keys: sign_str += key + params[key] sign_str += APP_SECRET # 5. 計算簽名 (HMAC-SHA256) sign = hmac.new(APP_SECRET.encode('utf-8'), sign_str.encode('utf-8'), hashlib.sha256).hexdigest().upper() params['sign'] = sign # 6. 發送請求 url = 'https://openapi.aliexpress.com/router/rest' response = requests.get(url, params=params) # 7. 處理響應 if response.status_code == 200: data = response.json() if data.get('code') == 200: # 或閑魚定義的成功碼 item_detail = data['data'] print("商品標題:", item_detail['title']) print("商品價格:", item_detail['price']['amount']) # ... 處理其他所需字段 else: print("API調用失敗:", data.get('message', '未知錯誤')) else: print("HTTP請求錯誤:", response.status_code)

注意事項

官方文檔： 上述接口名、參數、簽名方式、返回字段等均以閑魚開放平臺官方最新文檔為準。務必仔細閱讀官方文檔。

權限申請： 調用商品詳情接口通常需要申請相應的API權限。

調用頻率： 嚴格遵守閑魚API的調用頻率限制（QPS），避免因頻繁調用導致接口被限流或封禁。

錯誤處理： 在代碼中需妥善處理網絡錯誤、API返回錯誤（如無效的 item_id、過期的 access_token、權限不足等）。

參數編碼： 注意參數值的URL編碼問題。

安全存儲： AppKey 和 AppSecret 是核心機密信息，務必妥善保管，避免泄露。access_token 也有時效性，需要適時刷新。

總結通過調用閑魚開放平臺的商品詳情API接口，開發者可以根據商品ID高效、準確地獲取商品的詳細信息。這為構建價格監控系統、商品信息聚合平臺、數據分析工具等應用提供了強大的數據支持。成功調用的關鍵在于理解認證機制（OAuth）、簽名算法以及嚴格按照官方文檔進行參數傳遞和錯誤處理。

審核編輯 黃宇