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

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

{
  "code": "0",
  "message": "success",
  "result": {
    "sku_id": 1234567890,
    "sku_name": "【京東自營(yíng)】XX品牌 手機(jī) 全網(wǎng)通 8GB+256GB 曜石黑",
    "price": {
      "jd_price": 2999.00, // 京東價(jià)
      "promotion_price": 2799.00 // 促銷價(jià)（若有）
    },
    "stock_state": 33, // 庫(kù)存狀態(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",
      "存儲(chǔ)": "256GB"
    },
    "pack_listing": "手機(jī) x1, 充電器 x1, 數(shù)據(jù)線 x1, 說(shuō)明書 x1, 取卡針 x1", // 包裝清單
    "brand_name": "XX品牌",
    "category_id": 9987,
    "category_name": "手機(jī)通訊",
    // ... 其他字段
  }
}

五、 注意事項(xiàng)與最佳實(shí)踐

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

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

錯(cuò)誤處理：仔細(xì)處理接口返回的錯(cuò)誤碼（非 0）。常見(jiàn)錯(cuò)誤包括：

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

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

令牌失效（code 如 1004）

商品不存在（code 如 1005）

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

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

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

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

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

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

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

import requests
import hashlib
import time
import json

# 基礎(chǔ)配置 (請(qǐng)?zhí)鎿Q為你的實(shí)際信息)
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ǔ)請(qǐng)求參數(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ī)則通常為：對(duì)所有參數(shù)按字母排序 -> 拼接成字符串 -> 加上app_secret -> 計(jì)算MD5/HMAC-SHA256
# sign = ... (此處省略具體簽名實(shí)現(xiàn))
all_params["sign"] = "GENERATED_SIGN"  # 替換為生成的簽名

# 發(fā)送請(qǐng)求 (假設(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"接口返回錯(cuò)誤: code={data['code']}, message={data['message']}")
else:
    print(f"HTTP請(qǐng)求失敗: status_code={response.status_code}")

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

?審核編輯 黃宇