{
  "method": "jd.sku.info.get",
  "sku_id": "1234567890", // 替換為實際的京東商品SKU ID
  "fields": "sku_id, sku_name, price, stock_state, image_path, ..." // 可選，指定需要返回的字段
}

四、 響應(yīng)數(shù)據(jù)結(jié)構(gòu)示例（簡化版） 一個成功的響應(yīng)可能包含如下結(jié)構(gòu)：

{
  "code": "0",
  "message": "success",
  "result": {
    "sku_id": 1234567890,
    "sku_name": "【京東自營】XX品牌 手機 全網(wǎng)通 8GB+256GB 曜石黑",
    "price": {
      "jd_price": 2999.00, // 京東價
      "promotion_price": 2799.00 // 促銷價（若有）
    },
    "stock_state": 33, // 庫存狀態(tài)碼（33通常代表有貨）
    "image_path": "jfs/t1/.../abc.jpg", // 圖片路徑
    "weight": 0.18, // 重量（kg）
    "sale_state": 1, // 上下架狀態(tài)（1上架）
    "spec_info": { // 規(guī)格屬性
      "顏色": "曜石黑",
      "內(nèi)存": "8GB",
      "存儲": "256GB"
    },
    "pack_listing": "手機 x1, 充電器 x1, 數(shù)據(jù)線 x1, 說明書 x1, 取卡針 x1", // 包裝清單
    "brand_name": "XX品牌",
    "category_id": 9987,
    "category_name": "手機通訊",
    // ... 其他字段
  }
}

五、 注意事項與最佳實踐

權(quán)限申請：確保你的應(yīng)用已經(jīng)申請了調(diào)用商品信息相關(guān)API的權(quán)限。

參數(shù)驗證：調(diào)用前務(wù)必驗證傳入的 sku_id 或 spu_id 的有效性。

錯誤處理：仔細處理接口返回的錯誤碼（非 0）。常見錯誤包括：

參數(shù)錯誤（code 如 1001）

權(quán)限不足（code 如 1003）

令牌失效（code 如 1004）

商品不存在（code 如 1005）

簽名安全：務(wù)必妥善保管 app_secret，并嚴格按照官方文檔實現(xiàn)簽名算法。簽名錯誤會導(dǎo)致請求被拒絕。

調(diào)用頻率限制：京東API通常有調(diào)用頻率限制（QPS）。避免高頻請求，合理設(shè)計程序邏輯（如使用緩存、異步隊列）。

數(shù)據(jù)緩存：對于變化不頻繁的數(shù)據(jù)（如商品名稱、規(guī)格屬性），可以在本地或服務(wù)端做適當(dāng)緩存，減少API調(diào)用次數(shù)。

版本兼容：關(guān)注API版本更新。官方可能會升級接口，注意保持代碼兼容性或及時遷移。

敏感信息：返回的數(shù)據(jù)可能包含商業(yè)信息，需遵守相關(guān)協(xié)議，注意數(shù)據(jù)安全和隱私保護。

使用官方文檔：京東API的細節(jié)（如精確的URL、方法名、參數(shù)名、錯誤碼含義、簽名規(guī)則）請務(wù)必以京東開放平臺最新的官方文檔為準。文檔是準確性的唯一來源。

六、 示例代碼片段（Python - 概念演示，不含完整簽名） 以下是一個非常簡化的Python請求示例（僅展示概念，實際簽名生成需按官方規(guī)則實現(xiàn)）：

import requests
import hashlib
import time
import json

# 基礎(chǔ)配置 (請?zhí)鎿Q為你的實際信息)
app_key = "YOUR_APP_KEY"
app_secret = "YOUR_APP_SECRET"  # 務(wù)必保密！
access_token = "YOUR_ACCESS_TOKEN"  # 需要提前獲取
api_url = "https://api.jd.com/routerjson"
method = "jd.sku.info.get"

# 構(gòu)建基礎(chǔ)請求參數(shù)
base_params = {
    "method": method,
    "app_key": app_key,
    "access_token": access_token,
    "timestamp": time.strftime("%Y-%m-%d %H:%M:%S", time.localtime()),
    "format": "json",
    "v": "1.0"
}

# 構(gòu)建業(yè)務(wù)參數(shù)
biz_params = {
    "sku_id": "1234567890"  # 目標(biāo)SKU ID
}

# 合并參數(shù)
all_params = {**base_params, **biz_params}

# TODO: 按照京東官方簽名規(guī)則生成簽名 sign
# 規(guī)則通常為：對所有參數(shù)按字母排序 -> 拼接成字符串 -> 加上app_secret -> 計算MD5/HMAC-SHA256
# sign = ... (此處省略具體簽名實現(xiàn))
all_params["sign"] = "GENERATED_SIGN"  # 替換為生成的簽名

# 發(fā)送請求 (假設(shè)為POST)
response = requests.post(api_url, data=all_params)

# 處理響應(yīng)
if response.status_code == 200:
    data = response.json()
    if data.get("code") == "0":
        sku_info = data.get("result")
        print("獲取SKU信息成功:")
        print(json.dumps(sku_info, indent=2, ensure_ascii=False))
    else:
        print(f"接口返回錯誤: code={data['code']}, message={data['message']}")
else:
    print(f"HTTP請求失敗: status_code={response.status_code}")

結(jié)語 京東平臺提供的商品SKU信息API接口是獲取商品核心數(shù)據(jù)的重要途徑。理解其調(diào)用流程、參數(shù)意義、返回結(jié)構(gòu)以及注意事項，對于開發(fā)者高效、穩(wěn)定地集成京東商品數(shù)據(jù)至關(guān)重要。請務(wù)必結(jié)合京東開放平臺的最新官方文檔進行開發(fā)，并遵守相關(guān)的使用規(guī)范。希望本文能為您使用該接口提供有益的指導(dǎo)。

?審核編輯 黃宇