一、引言
在電商數據分析、競品研究、價格監控等眾多場景中，獲取商品的詳細信息至關重要。1688 作為國內知名的批發采購平臺，擁有海量的商品資源。其提供的商品詳情 API 為開發者和企業提供了便捷的途徑，能夠快速、準確地獲取商品的各類詳細信息，如商品標題、價格、規格、圖片、庫存等。通過對這些信息的分析和利用，可以為企業的決策提供有力支持，幫助商家優化商品策略，提升市場競爭力。小編：Taobaoapi2014, 前往體驗API：c0b.cc/R4rbK2 。
二、接口概述
1. 接口用途
1688 商品詳情 API 主要用于獲取指定商品在 1688 平臺上的詳細信息。開發者可以根據商品的 ID 來調用該接口，從而獲取商品的多維度信息，為后續的業務處理提供數據基礎。
2. 接入條件
- 注冊開發者賬號：需要在 1688 開放平臺注冊成為開發者，完成相關的認證流程，獲取開發者的身份標識。
- 創建應用：在開放平臺上創建一個應用，獲取
app_key和app_secret，這兩個參數是調用 API 時進行身份驗證的重要憑證。 - 申請權限：針對商品詳情 API 接口，需要在開放平臺上申請調用該接口的權限，只有獲得授權后才能正常調用。
3. 接口參數
- 公共參數：包括
app_key、timestamp（請求時間戳）、sign（簽名，用于驗證請求的合法性）、format（返回數據的格式，通常為 JSON 或 XML）等。 - 業務參數：主要是商品 ID，用于指定要獲取詳情的具體商品。
4. 接口返回值
接口返回的數據格式一般為 JSON 或 XML，包含了商品的詳細信息，常見的字段有：
- 商品基本信息：如商品標題、價格、起訂量、單位等。
- 商品描述信息：商品的詳細描述、規格參數等。
- 商品圖片信息：商品的主圖、細節圖等圖片的鏈接。
- 商家信息：商家的名稱、聯系方式等。
三、Python 請求示例
以下是一個使用 Python 的 requests 庫調用 1688 商品詳情 API 的示例代碼：
import requests
import time
import hashlib
假設 API 接口地址，復制鏈接獲取測試。
API url=c0b.cc/R4rbK2 wechat id:Taobaoapi2014"
# 生成簽名
def generate_sign(params, app_secret):
sorted_params = sorted(params.items(), key=lambda x: x[0])
sign_str = app_secret
for key, value in sorted_params:
sign_str += f'{key}{value}'
sign_str += app_secret
sign = hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()
return sign
# 商品 ID，可替換為你要查詢的商品 ID
product_id = '123456789'
# 構造請求參數
params = {
'app_key': app_key,
'timestamp': str(int(time.time() * 1000)),
'format': 'json',
'productId': product_id
}
# 生成簽名并添加到參數中
params['sign'] = generate_sign(params, app_secret)
# 發送請求
try:
response = requests.get(api_url, params=params)
response.raise_for_status()
result = response.json()
print(result)
except requests.exceptions.RequestException as e:
print(f"請求出錯: {e}")
except ValueError as e:
print(f"解析 JSON 數據出錯: {e}")
代碼說明
- 配置信息：你需要將
app_key和app_secret替換為你在 1688 開放平臺創建應用后獲取的實際信息。 - 生成簽名：1688 API 要求對請求參數進行簽名，以保證請求的安全性。
generate_sign函數用于生成簽名，它會對參數進行排序并拼接，然后使用 MD5 算法進行加密。 - 構造請求參數：根據 API 文檔的要求，構造請求所需的參數，包括公共參數和業務參數（商品 ID）。
- 發送請求：使用
requests.get方法發送請求，并處理可能出現的異常，如請求錯誤或 JSON 解析錯誤。
