?

京東平臺提供了強大的商品搜索API接口，開發(fā)者可通過關(guān)鍵詞獲取商品列表、價格、銷量等核心數(shù)據(jù)。以下是完整的實踐方案：

一、API基礎(chǔ)信息

接口地址

https://api.jd.com/routerjson

請求方式
POST（需攜帶簽名參數(shù)）

認(rèn)證機制

使用App Key和App Secret生成簽名

簽名算法：
$$ text{sign} = text{md5}(text{appSecret} + text{params} + text{appSecret}) $$

二、核心請求參數(shù)

三、響應(yīng)數(shù)據(jù)結(jié)構(gòu)示例

{
  "code": 200,
  "data": {
    "total": 1200,
    "goods_list": [
      {
        "skuId": "1000001",
        "name": "華為Mate60 Pro 5G手機",
        "price": 6999.00,
        "commission": 300,
        "comments": 50000,
        "shop_name": "華為官方旗艦店"
      }
    ]
  }
}

四、Python調(diào)用示例

import requests
import hashlib
import urllib.parse

def jd_goods_search(keyword, page=1):
    app_key = "YOUR_APP_KEY"
    app_secret = "YOUR_APP_SECRET"
    method = "jd.union.open.goods.query"
    
    # 構(gòu)造基礎(chǔ)參數(shù)
    params = {
        "method": method,
        "keyword": urllib.parse.quote(keyword),
        "page_index": page,
        "page_size": 20,
        "sort_name": "price"
    }
    
    # 生成簽名
    param_str = "".join([f"{k}{v}" for k,v in sorted(params.items())])
    sign = hashlib.md5((app_secret + param_str + app_secret).encode()).hexdigest()
    params.update({"sign": sign, "app_key": app_key})
    
    # 發(fā)送請求
    response = requests.post("https://api.jd.com/routerjson", data=params)
    return response.json() if response.status_code == 200 else None

# 調(diào)用示例
result = jd_goods_search("智能手機")
print(result["data"]["goods_list"][0]["name"])  # 輸出：華為Mate60 Pro 5G手機

五、關(guān)鍵注意事項

關(guān)鍵詞編碼
必須使用urllib.parse.quote()處理中文關(guān)鍵詞，避免亂碼

錯誤碼處理

1001：參數(shù)缺失 → 檢查必填字段

1004：簽名錯誤 → 驗證appSecret和加密邏輯

1010：調(diào)用頻次超限 → 控制請求速率（默認(rèn)100次/分鐘）

數(shù)據(jù)更新頻率
商品價格實時更新，庫存數(shù)據(jù)緩存周期為5分鐘

六、應(yīng)用場景

比價系統(tǒng)開發(fā)

競品監(jiān)控分析

商品推薦引擎

供應(yīng)鏈庫存預(yù)警

通過合理利用分頁參數(shù)和排序規(guī)則，可高效獲取海量商品數(shù)據(jù)，為電商生態(tài)開發(fā)提供強大支撐。

審核編輯 黃宇

?