京東商品 SKU 接口是獲取商品規格、庫存、價格等核心數據的關鍵技術入口 —— 和評論接口不同，SKU 數據更側重 “結構化屬性”，比如顏色 / 尺寸規格映射、不同 SKU 的庫存差異、區域定價規則等，這些數據對庫存同步、商品上架、價格監控至關重要。

之前折騰京東接口時，光 SKU 的 “規格值編碼映射” 就踩過不少坑（比如同一個 “紅色” 在不同商品里編碼不一樣），后來整理了一套完整的技術方案。這篇純技術視角拆解接口對接全流程，聚焦參數配置、簽名生成、規格解析等核心環節，附上能直接跑的代碼和自己踩過的坑，幫大家少走彎路。

一、接口核心技術參數與權限基礎

1. 關鍵技術參數（必選 / 可選標注）

SKU 接口參數對 “格式精度” 要求極高，比如 SKU ID 必須是純數字，區域編碼需匹配京東標準，任一參數錯誤會直接返回 “參數校驗失敗”：

2. 權限申請技術要點

SKU 接口權限審核比評論接口更關注 “數據用途合規性”，需注意這幾個技術細節：

開發者認證：個人認證需提交身份證正反面 + 手持照，企業認證需額外提供營業執照（需與應用主體一致），避免因主體不匹配導致權限被拒；

接口用途說明：需明確標注 “用于內部商品數據管理、庫存同步”，避免出現 “商業爬取”“外部數據分發” 等違規表述，可附簡單的技術架構圖（如 “SKU 接口→數據存儲→庫存管理系統”）；

配額管理：個人開發者默認日調用限額 500 次，企業開發者 3000 次，若需更高配額，需提供 “業務量證明”（如店鋪日訂單量、商品 SKU 總數）。

二、核心技術實現：從簽名到規格解析

1. 簽名生成機制（SKU 接口專屬坑點）

SKU 接口簽名規則和評論接口一致，但需注意 “area_id 為空時的參數處理”—— 空值參數無需參與簽名，否則會導致 “簽名無效”，技術實現如下：

import hashlib import sortedcontainers def generate_sku_sign(params: dict, app_secret: str) -> str: """ 生成京東SKU接口簽名（處理空值參數，避免簽名錯誤） :param params: 待簽名參數字典（不含sign字段） :param app_secret: 應用密鑰 :return: 32位大寫簽名字符串 """ # 坑點1：過濾空值參數（area_id等可選參數為空時不參與簽名） valid_params = {k: v for k, v in params.items() if v is not None and str(v).strip() != ""} # 坑點2：按參數名ASCII碼升序排序（用SortedDict確保排序穩定性） sorted_params = sortedcontainers.SortedDict(valid_params) # 坑點3：拼接格式為"keyvalue"（無分隔符），首尾必須加app_secret sign_str = app_secret for key, value in sorted_params.items(): # 坑點4：參數值需轉為字符串（數字型參數如area_id不轉會導致簽名偏差） sign_str += f"{key}{str(value)}" sign_str += app_secret # 坑點5：必須用UTF-8編碼（含中文的field參數會導致加密錯誤） return hashlib.md5(sign_str.encode("utf-8")).hexdigest().upper() 2. 接口調用客戶端（含規格解析） SKU 接口核心技術難點是 “規格值編碼映射”（如 “1627207:3232483” 對應 “顏色：紅色”）和 “區域庫存差異處理”，客戶端實現如下： import requests import json import time import logging from dataclasses import dataclass from typing import List, Optional, Dict # 日志配置（技術調試必備，記錄詳細錯誤信息） logging.basicConfig( level=logging.INFO, format='%(asctime)s - %(module)s - %(levelname)s - %(message)s' ) logger = logging.getLogger("jd-sku-api") # SKU數據模型（結構化存儲，避免字段混亂） @dataclass class JdSkuModel: sku_id: str # SKU唯一ID ware_id: str # 商品主ID spec_text: str # 規格描述（如“紅色-XXL”） spec_code_map: Dict[str, str] # 規格編碼映射（如{"顏色":"3232483","尺寸":"12345"}） stock: int # 庫存數量 price: float # 銷售價格 original_price: float # 原價 area_id: str # 區域編碼 status: str # 狀態（1-在售，0-下架） create_time: str # 創建時間 class JdSkuAPIClient: def __init__(self, app_key: str, app_secret: str, timeout: tuple = (3, 10)): self.app_key = app_key self.app_secret = app_secret self.base_url = "京東開放平臺SKU接口指定地址" # 按平臺文檔配置，無硬編碼鏈接 self.timeout = timeout # 初始化長連接（減少TCP握手開銷，提升并發性能） self.session = self._init_session() def _init_session(self) -> requests.Session: """初始化請求會話，配置連接池與重試機制""" session = requests.Session() adapter = requests.adapters.HTTPAdapter( pool_connections=10, pool_maxsize=50, # 重試策略：針對5xx錯誤自動重試3次，避免臨時網絡問題 max_retries=requests.packages.urllib3.util.retry.Retry( total=3, status_forcelist=[500, 502, 503, 504], backoff_factor=0.5 ) ) session.mount('https://', adapter) return session def _validate_params(self, params: dict) -> bool: """參數校驗（SKU接口參數校驗嚴格，需逐項檢查）""" # 校驗sku_id格式（純數字） if not params.get("sku_id").isdigit(): logger.error(f"SKU ID格式錯誤：{params.get('sku_id')}（需純數字）") return False # 校驗area_id（若傳則為純數字） area_id = params.get("area_id") if area_id is not None and not str(area_id).isdigit(): logger.error(f"區域編碼格式錯誤：{area_id}（需純數字）") return False # 校驗時間戳格式 try: time.strptime(params.get("timestamp"), "%Y-%m-%d %H:%M:%S") except ValueError: logger.error(f"時間戳格式錯誤：{params.get('timestamp')}（需YYYY-MM-DD HH:MM:SS）") return False return True def get_sku_info(self, sku_id: str, area_id: Optional[str] = None, fields: Optional[List[str]] = None) -> dict: """ 核心方法：獲取SKU詳情數據 :param sku_id: SKU唯一ID :param area_id: 區域編碼（可選） :param fields: 需返回字段列表（可選） :return: 結構化結果（含成功狀態、SKU數據） """ # 1. 構建基礎參數字典 base_params = { "method": "jingdong.ware.sku.get", "app_key": self.app_key, "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"), "format": "json", "v": "2.0", "sign_method": "md5", "sku_id": sku_id, "area_id": area_id, # 可選參數，為空時自動過濾 "field": ",".join(fields) if fields else None # 字段篩選 } # 2. 參數校驗與簽名生成 if not self._validate_params(base_params): return {"success": False, "error": "參數格式校驗失敗"} base_params["sign"] = generate_sku_sign(base_params, self.app_secret) # 3. 發送請求（SKU接口僅支持POST，GET會返回405錯誤） try: response = self.session.post( url=self.base_url, data=base_params, # 參數放data中，非params headers={"Content-Type": "application/x-www-form-urlencoded"}, timeout=self.timeout ) response.raise_for_status() # 捕獲4xx/5xx HTTP錯誤 # 4. 解析響應數據 try: result = json.loads(response.text) except json.JSONDecodeError as e: logger.error(f"JSON解析失?。簕str(e)}，響應片段：{response.text[:500]}") return {"success": False, "error": "響應數據格式異常"} # 5. 處理業務錯誤（京東錯誤碼：0為成功） if result.get("code") != 0: error_msg = result.get("message", "未知業務錯誤") error_code = result.get("code", "未知錯誤碼") logger.error(f"接口業務錯誤：{error_msg}（錯誤碼：{error_code}）") return {"success": False, "error": f"{error_msg}（錯誤碼：{error_code}）"} # 6. 結構化SKU數據（核心：解析規格編碼映射） raw_sku = result.get("data", {}).get("sku", {}) if not raw_sku: logger.error(f"未獲取到SKU數據：sku_id={sku_id}") return {"success": False, "error": "未獲取到SKU數據"} parsed_sku = self._parse_sku_data(raw_sku, area_id) return { "success": True, "sku_info": parsed_sku } except requests.exceptions.RequestException as e: logger.error(f"請求異常：{str(e)}") return {"success": False, "error": f"請求異常：{str(e)}"} except Exception as e: logger.error(f"未知處理異常：{str(e)}") return {"success": False, "error": f"未知處理異常：{str(e)}"} def _parse_sku_data(self, raw_sku: dict, area_id: Optional[str]) -> JdSkuModel: """ 解析SKU原始數據（核心技術點：規格編碼映射與價格處理） :param raw_sku: 接口返回的原始SKU數據 :param area_id: 區域編碼（用于填充模型） :return: 結構化JdSkuModel """ # 解析規格編碼映射（如"spec_json":"{"顏色":"3232483","尺寸":"12345"}"） spec_code_map = {} spec_json = raw_sku.get("spec_json", "{}") try: spec_code_map = json.loads(spec_json) except json.JSONDecodeError: logger.warning(f"規格JSON解析失?。簕spec_json}，用空字典替代") # 解析規格描述（如"spec_text":"紅色-XXL"） spec_text = raw_sku.get("spec_text", "未知規格") # 價格處理（京東返回價格為分單位，需轉為元） price = float(raw_sku.get("price", 0)) / 100.0 original_price = float(raw_sku.get("original_price", 0)) / 100.0 # 庫存處理（部分商品返回"stock":""，需轉為0） stock_str = raw_sku.get("stock", "0") stock = int(stock_str) if stock_str.isdigit() else 0 return JdSkuModel( sku_id=str(raw_sku.get("sku_id", "")), ware_id=str(raw_sku.get("ware_id", "")), spec_text=spec_text, spec_code_map=spec_code_map, stock=stock, price=round(price, 2), original_price=round(original_price, 2), area_id=area_id or "", status="在售" if raw_sku.get("status") == 1 else "下架", create_time=raw_sku.get("create_time", "") ) # 使用示例（需替換為實際app_key與app_secret） if __name__ == "__main__": client = JdSkuAPIClient( app_key="your_app_key", app_secret="your_app_secret" ) # 獲取SKU信息（指定區域為北京，僅返回核心字段） result = client.get_sku_info( sku_id="100012014970", area_id="110100", fields=["sku_id", "ware_id", "spec_text", "stock", "price"] ) if result["success"]: sku = result["sku_info"] logger.info(f"SKU詳情：{sku.sku_id} | 規格：{sku.spec_text} | 庫存：{sku.stock} | 價格：{sku.price}")

三、高頻技術坑與解決方案（個人踩坑總結）

四、技術互動交流

以上內容是自己對接京東 SKU 接口時整理的技術方案，從簽名生成到規格解析都踩過不少坑，代碼里的每處注釋基本都是遇到問題后補充的。如果大家在實際對接中遇到 “規格編碼映射混亂”“區域庫存不生效”“價格單位轉換錯誤” 等技術問題，或者有關于 “高并發優化”“字段篩選技巧” 的疑問，歡迎在評論區留言 —— 技術問題不怕細，一起探討解決方案，少走沒必要的彎路～

審核編輯 黃宇