京東商品詳情API返回值核心字段說明
一、商品基礎信息
- 商品ID（skuId/productId）
- 唯一標識符，用于定位具體商品或SKU（如不同顏色、尺寸的變體）。
- 示例：
"skuId": "123456789"
- 商品標題（title）
- 包含品牌、型號、核心功能的描述性文本。
- 示例：
"title": "Redmi K60 Pro 5G手機 12GB+256GB 墨羽"
- 商品圖片（images/item_imgs）
- 返回主圖、詳情圖、視頻封面等多張圖片的URL列表，支持高清展示。
- 示例：
json"images": ["https://img.jd.com/detail1.jpg","https://img.jd.com/detail2.jpg"]
- 商品描述（description/desc）
- 詳細介紹材質、功能、使用方法等，可能包含HTML標簽或純文本。
- 示例：
"desc": "搭載驍龍8 Gen2處理器，支持120W快充..."
二、價格與促銷信息
- 價格字段
- price：當前售價（元）。
- original_price：原價（用于劃線價展示）。
- promotion：促銷活動詳情，如滿減、折扣、贈品等。
- 示例：
json"price": 2999.00,"original_price": 3299.00,"promotion": {"type": "滿減","desc": "滿3000減300","valid_time": "2025-07-25至2025-07-31"}
- SKU價格列表（skuList）
- 返回不同規格（如顏色、內存）的價格及庫存。
- 示例：
json"skuList": [{"skuId": "123456","name": "墨羽 12GB+256GB","price": 2999.00,"stock": 50}]
三、庫存與狀態
- 庫存數量（stock/quantity）
- 實時庫存數據，支持判斷商品可售性。
- 示例：
"stock": 50
- 庫存狀態
- 可能返回
"inStock"（有貨）、"outOfStock"（無貨）等枚舉值。
- 可能返回
四、商品屬性與分類
- 商品屬性（attributes/props）
- 包含顏色、尺寸、重量、產地等結構化數據。
- 示例：
json"attributes": [{"name": "顏色", "value": "墨羽"},{"name": "內存", "value": "12GB+256GB"}]
- 分類信息（category）
- 商品所屬的類目路徑，如“手機>5G手機>Redmi”。
- 示例：
json"category": {"id": "123","name": "5G手機"}
五、品牌與售后服務
- 品牌信息（brand）
- 包含品牌ID、名稱及Logo鏈接。
- 示例：
json"brand": {"id": "1001","name": "Redmi","logo": "https://img.jd.com/brand/logo.jpg"}
- 售后服務（afterSaleService）
- 退換貨政策、保修期限等。
- 示例：
json"afterSaleService": {"return_policy": "7天無理由退貨","warranty": "1年質保"}
六、評價與銷量
- 評價數據（reviews）
- 可能返回評價數量、評分（如4.8分）、好評率等。
- 示例：
json"reviews": {"count": 1000,"rating": 4.8,"positive_rate": "95%"}
- 銷量數據（sales）
- 30天銷量、總銷量等（需申請權限）。
- 示例：
"monthly_sales": 5000
京東API接入流程
一、注冊與權限申請
- 注冊開發者賬號
- 訪問京東開放平臺，完成企業或個人認證。
- 創建應用
- 在控制臺創建應用，填寫名稱、描述，選擇“商品詳情API”權限。
- 獲取API密鑰
- 審核通過后，獲取
AppKey和AppSecret，用于身份驗證。
- 審核通過后，獲取
二、接口調用規范
- 請求方式
- 通常為
POST請求，URL如：https://api.jd.com/routerjson
- 通常為
- 請求參數
- 必填參數：
method（接口方法名）、app_key、timestamp、v（版本號）、param_json（JSON格式的查詢條件）。 - 示例：
json{"method": "jd.union.open.goods.detail.query","app_key": "YOUR_APP_KEY","timestamp": "2025-07-25 17:00:00","v": "1.0","param_json": "{\"skuIds\": [\"123456789\"]}"}
- 必填參數：
- 簽名生成
- 按字典序排序參數，拼接
AppSecret后進行MD5加密并轉大寫。 - Python示例：
pythonimport hashlibdef generate_sign(params, app_secret):sorted_params = sorted(params.items())sign_str = app_secret + ''.join(f"{k}{v}" for k, v in sorted_params) + app_secretreturn hashlib.md5(sign_str.encode()).hexdigest().upper()
- 按字典序排序參數，拼接
三、響應處理與錯誤碼
- 響應格式
- 返回JSON數據，包含
code（狀態碼）、message（錯誤信息）、data（業務數據）。 - 成功示例：
json{"code": "0000","message": "成功","data": {"item": {"title": "Redmi K60 Pro","price": 2999.00}}}
- 返回JSON數據，包含
- 常見錯誤碼
1001：參數缺失3005：商品不存在4001：簽名驗證失敗5000：QPS超限（默認1000次/分鐘，需申請提額）
應用場景與優化建議
- 比價系統
- 實時監控競品價格波動，結合促銷信息生成優惠提醒。
- 庫存預警
- 同步庫存數據至ERP系統，觸發低庫存自動補貨。
- 營銷活動生成
- 自動抓取滿減、贈品規則，生成個性化推薦文案。
- 性能優化
- 緩存策略：對靜態數據（如商品描述）本地緩存，減少API調用。
- 字段過濾：通過
fields參數指定返回字段，降低網絡負載。 - 批量查詢：支持最多20個SKU同時查詢，提升效率。
)
