一、引言
在電商數(shù)據(jù)驅(qū)動(dòng)的時(shí)代，精準(zhǔn)且高效地獲取商品信息是眾多業(yè)務(wù)場(chǎng)景的關(guān)鍵需求。1688，作為國(guó)內(nèi)知名的 B2B 電商平臺(tái)，擁有海量豐富的商品資源。其開(kāi)放的商品詳情 API 接口，為開(kāi)發(fā)者、數(shù)據(jù)分析師以及電商從業(yè)者搭建了一座通向這些寶貴數(shù)據(jù)的橋梁。通過(guò)該接口，能夠自動(dòng)化、批量地獲取商品的詳細(xì)信息，涵蓋從基礎(chǔ)屬性到銷(xiāo)售數(shù)據(jù)、商家詳情等多維度內(nèi)容。無(wú)論是構(gòu)建電商選品工具、進(jìn)行市場(chǎng)價(jià)格分析。
二、接口概述
1.接口功能
- 基礎(chǔ)信息獲取：可獲取商品的標(biāo)題、品牌、型號(hào)等基礎(chǔ)屬性，例如一款 “小米 13 手機(jī)”，接口能精準(zhǔn)返回其品牌為 “小米”，型號(hào)是 “13”，以及詳細(xì)的商品標(biāo)題如 “小米 13 驍龍 8 Gen2 處理器 徠卡影像 120Hz 高刷屏幕 手機(jī)”。
- 價(jià)格體系展示：提供商品的價(jià)格詳情，包括單買(mǎi)價(jià)格、不同起訂量下的批發(fā)價(jià)格，以及可能存在的價(jià)格區(qū)間波動(dòng)情況。以某款文具批發(fā)為例，接口會(huì)返回購(gòu)買(mǎi) 1 - 10 件時(shí)單價(jià)為 5 元，11 - 50 件時(shí)單價(jià) 4.5 元等價(jià)格信息。
- 庫(kù)存狀況查詢(xún)：實(shí)時(shí)呈現(xiàn)商品的庫(kù)存數(shù)量，便于商家和采購(gòu)者及時(shí)了解商品的可售情況，避免超賣(mài)或缺貨情況的發(fā)生。如顯示某款運(yùn)動(dòng)器材 “庫(kù)存：300 件”。
- 圖片與描述：返回商品多角度高清圖片鏈接，幫助用戶(hù)全面了解商品外觀；同時(shí)，獲取詳細(xì)的商品描述信息，涵蓋產(chǎn)品特點(diǎn)、使用方法、材質(zhì)等內(nèi)容，輔助用戶(hù)做出購(gòu)買(mǎi)決策。像一款家具商品，接口會(huì)提供多張不同角度展示其外觀的圖片鏈接，以及詳細(xì)描述其材質(zhì)為實(shí)木、風(fēng)格為北歐風(fēng)、尺寸規(guī)格等文字信息。
- 商家信息呈現(xiàn)：展示商品所屬商家在 1688 平臺(tái)的注冊(cè)名稱(chēng)、聯(lián)系方式（如旺旺 ID、聯(lián)系電話(huà)）、店鋪等級(jí)等信息，增加商家透明度，方便供需雙方進(jìn)一步溝通合作。
2.請(qǐng)求參數(shù)
- 商品 ID（必填） ：這是 1688 平臺(tái)為每個(gè)商品賦予的唯一標(biāo)識(shí)符，類(lèi)似于商品的 “身份證號(hào)”。通過(guò)準(zhǔn)確傳入商品 ID，接口能夠精準(zhǔn)定位目標(biāo)商品，返回與之對(duì)應(yīng)的詳細(xì)信息。例如，商品 ID 為 “123456”，接口會(huì)針對(duì)該 ID 對(duì)應(yīng)的商品進(jìn)行數(shù)據(jù)查詢(xún)與返回。
- 語(yǔ)言參數(shù)（可選） ：用于指定返回?cái)?shù)據(jù)的語(yǔ)言類(lèi)型，在全球化業(yè)務(wù)拓展背景下極為重要。設(shè)置 “l(fā)anguage = zh_CN”，將獲取中文簡(jiǎn)體版本的商品詳情信息；設(shè)置 “l(fā)anguage = en_US”，則返回英文版本詳情，滿(mǎn)足不同語(yǔ)言背景用戶(hù)的需求。
響應(yīng)數(shù)據(jù)
接口返回的數(shù)據(jù)通常為 JSON 格式，方便解析與處理，主要包含以下內(nèi)容：
- 商品基本信息：包括商品名稱(chēng)、所屬類(lèi)目（如 “數(shù)碼產(chǎn)品 - 手機(jī)”）、品牌、型號(hào)等。
- 價(jià)格與庫(kù)存：價(jià)格區(qū)間、不同規(guī)格對(duì)應(yīng)的價(jià)格、當(dāng)前庫(kù)存數(shù)量等。
- 圖片列表：以數(shù)組形式呈現(xiàn)商品的多角度圖片鏈接，用戶(hù)可通過(guò)點(diǎn)擊鏈接查看高清圖片，了解商品細(xì)節(jié)。
- 商品描述：詳細(xì)的商品介紹，包含產(chǎn)品特點(diǎn)、使用方法、材質(zhì)等文字內(nèi)容。
- 商家詳情：商家名稱(chēng)、旺旺 ID、聯(lián)系電話(huà)、店鋪等級(jí)、商家地址等信息。
三、Python 請(qǐng)求示例
使用Python請(qǐng)求1688商品詳情API接口請(qǐng)求示例代碼：
import requests
import hashlib
import urllib.parse
import time
# 假設(shè) API 封裝接口地址
API url=c0b.cc/R4rbK2 wechat id:Taobaoapi2014
# 商品ID
item_id = "1234567890" # 替換為實(shí)際商品ID
timestamp = time.strftime("%Y-%m-%d %H:%M:%S", time.localtime())
# 構(gòu)建請(qǐng)求參數(shù)
params = {
"app_key": app_key,
"method": "com.alibaba.product.getProductDetailInfo", # 接口方法名，根據(jù)實(shí)際接口文檔調(diào)整
"timestamp": timestamp,
"format": "json",
"v": "2.0",
"item_id": item_id
}
# 生成簽名
sign = create_sign_string(params, app_secret)
params["sign"] = sign
# 發(fā)送請(qǐng)求
response = requests.get('https://gw.open.1688.com/openapi/param2/2/xxxxx/xxxxx', params=params)
# 檢查響應(yīng)狀態(tài)碼
if response.status_code == 200:
result = response.json()
# 提取并處理所需數(shù)據(jù)
if result.get("product"):
product = result["product"]
title = product.get("title")
price = product.get("price")
stock = product.get("stock")
print(f"商品標(biāo)題: {title}")
print(f"商品價(jià)格: {price}")
print(f"商品庫(kù)存: {stock}")
else:
print(f"請(qǐng)求失敗，狀態(tài)碼: {response.status_code}")
在實(shí)際應(yīng)用中，務(wù)必將代碼中的item_id替換為真實(shí)有效的信息，同時(shí)根據(jù) 1688 開(kāi)放平臺(tái)最新的接口文檔，對(duì)接口地址、接口方法名、參數(shù)名稱(chēng)及簽名算法等進(jìn)行準(zhǔn)確調(diào)整與適配。
