?

在電商開發(fā)中，整合京東平臺數(shù)據(jù)是常見需求。本文將一步步指導(dǎo)您通過京東開放平臺API獲取指定店鋪的所有商品信息。京東API采用OAuth 2.0認(rèn)證，支持分頁查詢，確保數(shù)據(jù)完整獲取。以下是詳細(xì)實(shí)現(xiàn)方案（基于京東開放平臺最新文檔，實(shí)際使用時請參考官方文檔確認(rèn)細(xì)節(jié)）。

步驟1: 準(zhǔn)備工作

注冊開發(fā)者賬號：訪問京東開放平臺，注冊賬號并創(chuàng)建應(yīng)用，獲取App Key和App Secret。

權(quán)限申請：在控制臺申請“商品信息讀取”權(quán)限，審核通過后獲得API調(diào)用資格。

工具準(zhǔn)備：推薦使用Python語言，安裝requests庫處理HTTP請求。

步驟2: 確定API接口

京東提供多個商品相關(guān)API，核心接口為jingdong.goods.get（獲取單個商品）和jingdong.goods.search（搜索商品）。要獲取所有商品，需使用搜索接口并添加店鋪ID參數(shù)：

API端點(diǎn)：https://api.jd.com/routerjson

請求方法：POST

關(guān)鍵參數(shù)：

method: 設(shè)為jingdong.goods.search

shop_id: 店鋪唯一ID（可從商家后臺獲?。?/p>

page_no: 頁碼（從1開始）

page_size: 每頁商品數(shù)（建議設(shè)為100，京東API上限）

其他參數(shù)如access_token（認(rèn)證令牌）需動態(tài)生成。

步驟3: 處理認(rèn)證和分頁

京東API需簽名認(rèn)證，使用HMAC-SHA256算法生成簽名。分頁邏輯基于總商品數(shù)$N$和每頁大小$S$，計算總頁數(shù)：
$$
text{總頁數(shù)} = leftlceil frac{N}{S} rightrceil
$$
其中$N$通過首次API響應(yīng)中的total字段獲取，$S$為page_size。循環(huán)調(diào)用API直到所有頁遍歷完成。

步驟4: 代碼實(shí)現(xiàn)示例

以下Python代碼演示完整流程（使用偽參數(shù)，替換為您的App Key、App Secret和shop_id）：

import requests
import hashlib
import time
import json

# 配置參數(shù)
app_key = "YOUR_APP_KEY"
app_secret = "YOUR_APP_SECRET"
shop_id = "YOUR_SHOP_ID"  # 替換為實(shí)際店鋪ID
access_token = "YOUR_ACCESS_TOKEN"  # 通過OAuth流程獲取

def generate_sign(params, app_secret):
    """生成API簽名（HMAC-SHA256）"""
    sorted_params = sorted(params.items())
    query_str = app_secret + ''.join([f"{k}{v}" for k, v in sorted_params]) + app_secret
    return hashlib.sha256(query_str.encode('utf-8')).hexdigest().upper()

def fetch_all_goods(shop_id, max_page_size=100):
    """獲取店鋪所有商品"""
    base_url = "https://api.jd.com/routerjson"
    all_goods = []
    page_no = 1
    total_pages = 1  # 初始值，后續(xù)更新
    
    while page_no <= total_pages:
        # 構(gòu)建請求參數(shù)
        params = {
            "method": "jingdong.goods.search",
            "timestamp": str(int(time.time())),
            "format": "json",
            "v": "2.0",
            "app_key": app_key,
            "shop_id": shop_id,
            "page_no": page_no,
            "page_size": max_page_size,
            "access_token": access_token
        }
        params["sign"] = generate_sign(params, app_secret)
        
        # 發(fā)送API請求
        response = requests.post(base_url, data=params)
        data = response.json()
        
        # 錯誤處理
        if "error_response" in data:
            error_code = data["error_response"]["code"]
            error_msg = data["error_response"]["msg"]
            raise Exception(f"API錯誤: 代碼{error_code}, 消息: {error_msg}")
        
        # 解析數(shù)據(jù)
        result = data["jingdong_goods_search_responce"]["result"]
        goods_list = result["goods_list"]
        total_goods = result["total"]  # 總商品數(shù)
        all_goods.extend(goods_list)
        
        # 更新分頁信息
        total_pages = (total_goods + max_page_size - 1) // max_page_size  # 計算總頁數(shù): $leftlceil frac{N}{S} rightrceil$
        page_no += 1
    
    return all_goods

# 執(zhí)行示例
try:
    goods_data = fetch_all_goods(shop_id)
    print(f"成功獲取{len(goods_data)}個商品")
    # 可保存為JSON文件: with open("jd_goods.json", "w") as f: json.dump(goods_data, f)
except Exception as e:
    print(f"獲取失敗: {e}")

步驟5: 數(shù)據(jù)解析與處理

API響應(yīng)為JSON格式，關(guān)鍵字段包括：

goods_list: 商品數(shù)組，每個商品含sku_id（商品ID）、name（名稱）、price（價格）等。

total: 總商品數(shù)，用于分頁控制。
建議存儲到數(shù)據(jù)庫或文件（如JSON/CSV），便于后續(xù)分析。

注意事項(xiàng)

頻率限制：京東API有調(diào)用頻率限制（通常100次/分鐘），超出會報錯code: 13，需添加延時（如time.sleep(0.5)）。

認(rèn)證更新：access_token有效期2小時，過期需刷新（使用refresh_token）。

數(shù)據(jù)完整性：確保處理網(wǎng)絡(luò)異常（添加重試機(jī)制），并校驗(yàn)響應(yīng)中的total與實(shí)際獲取數(shù)是否一致。

官方參考：京東API可能更新，請定期查看文檔。

通過以上步驟，您可以高效集成京東商品數(shù)據(jù)。如有疑問，歡迎在評論區(qū)討論！

?
審核編輯 黃宇