?

在電商開發(fā)中，實時獲取商品券后價格是提升用戶體驗的關鍵功能。京東平臺通過開放API接口，允許開發(fā)者查詢商品在應用優(yōu)惠券后的實際價格。本文將逐步介紹如何調用京東券后價API，包括準備工作、接口調用方法、參數解析和示例代碼，幫助您快速集成該功能。

一、API概述

京東券后價API屬于京東宙斯開放平臺的一部分，主要用于：

查詢單個或多個商品的券后價格

支持動態(tài)優(yōu)惠券（如滿減券、折扣券）的計算

返回JSON格式數據，包含原價、券后價、優(yōu)惠詳情等字段

典型應用場景：

比價插件開發(fā)

購物車價格實時更新

營銷活動頁面展示

二、準備工作

在調用API前，需完成以下步驟：

注冊開發(fā)者賬號

訪問京東宙斯開放平臺

創(chuàng)建企業(yè)級應用，獲取App Key和App Secret

申請API權限

在控制臺申請商品價格接口權限（通常為jingdong.price.get類接口）

環(huán)境配置

確保開發(fā)環(huán)境支持HTTPS請求

安裝必要庫（如Python的requests庫）

三、API調用說明

請求方式

HTTP方法: GET

Endpoint: https://router.jd.com/api

認證: 通過sign參數進行MD5簽名（基于App Secret和請求參數生成）

核心請求參數

簽名生成規(guī)則

簽名sign的計算公式：

將所有參數按key升序排序

拼接為字符串：key1=value1&key2=value2...

追加App Secret：拼接字符串 + App Secret

計算MD5哈希值：$$ text{sign} = text{MD5}(text{拼接字符串}) $$

四、響應解析

成功響應示例（JSON）

{  
  "code": "0",  
  "data": {  
    "results": [  
      {  
        "sku_id": "123456",  
        "original_price": 299.00,  
        "coupon_price": 249.00,  
        "coupons": [  
          {"coupon_id": "C789", "discount": 50.00}  
        ]  
      }  
    ]  
  }  
}  

關鍵字段說明

code: 響應狀態(tài)碼（0表示成功）

original_price: 商品原價

coupon_price: 券后實際價格

discount: 優(yōu)惠金額

錯誤處理

code != 0時檢查msg字段，常見錯誤：

1001: 參數缺失

2002: 簽名驗證失敗

3005: 商品不存在

五、Python示例代碼

以下代碼演示如何調用券后價API（需替換YOUR_APP_KEY和YOUR_APP_SECRET）：

import requests  
import hashlib  
import time  

# 配置參數  
APP_KEY = "YOUR_APP_KEY"  
APP_SECRET = "YOUR_APP_SECRET"  
SKU_IDS = "100001,100002"  # 示例商品SKU  
TIMESTAMP = time.strftime("%Y-%m-%d %H:%M:%S")  

# 1. 構建基礎參數  
params = {  
    "method": "jingdong.union.open.goods.coupon.query",  
    "app_key": APP_KEY,  
    "timestamp": TIMESTAMP,  
    "sku_ids": SKU_IDS,  
    "v": "2.0",  
    "format": "json"  
}  

# 2. 生成簽名  
sorted_params = sorted(params.items())  
query_str = "&".join([f"{k}={v}" for k, v in sorted_params])  
sign_str = query_str + APP_SECRET  
sign = hashlib.md5(sign_str.encode()).hexdigest()  
params["sign"] = sign  

# 3. 發(fā)送請求  
url = "https://router.jd.com/api"  
response = requests.get(url, params=params)  
data = response.json()  

# 4. 處理響應  
if data.get("code") == "0":  
    for item in data["data"]["results"]:  
        print(f"商品SKU: {item['sku_id']}, 券后價: ￥{item['coupon_price']}")  
else:  
    print(f"API調用失敗: {data.get('msg')}")  

六、注意事項

頻率限制

免費版API限制 100次/分鐘，超出需購買配額

數據實時性

券后價基于京東實時庫存和優(yōu)惠規(guī)則，結果可能因促銷變動

安全建議

在服務端調用API，避免App Secret前端暴露

使用HTTPS加密傳輸

調試工具

利用京東開放平臺的在線調試器驗證參數

通過本指南，您可快速集成京東券后價功能。如有任何疑問，歡迎大家留言探討。

?
審核編輯 黃宇