?

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

一、API概述

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

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

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

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

典型應(yīng)用場景：

比價插件開發(fā)

購物車價格實時更新

營銷活動頁面展示

二、準(zhǔn)備工作

在調(diào)用API前，需完成以下步驟：

注冊開發(fā)者賬號

訪問京東宙斯開放平臺

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

申請API權(quán)限

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

環(huán)境配置

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

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

三、API調(diào)用說明

請求方式

HTTP方法: GET

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

認(rèn)證: 通過sign參數(shù)進(jìn)行MD5簽名（基于App Secret和請求參數(shù)生成）

核心請求參數(shù)

簽名生成規(guī)則

簽名sign的計算公式：

將所有參數(shù)按key升序排序

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

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

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

四、響應(yīng)解析

成功響應(yīng)示例（JSON）

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

關(guān)鍵字段說明

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

original_price: 商品原價

coupon_price: 券后實際價格

discount: 優(yōu)惠金額

錯誤處理

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

1001: 參數(shù)缺失

2002: 簽名驗證失敗

3005: 商品不存在

五、Python示例代碼

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

import requests  
import hashlib  
import time  

# 配置參數(shù)  
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. 構(gòu)建基礎(chǔ)參數(shù)  
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. 處理響應(yīng)  
if data.get("code") == "0":  
    for item in data["data"]["results"]:  
        print(f"商品SKU: {item['sku_id']}, 券后價: ￥{item['coupon_price']}")  
else:  
    print(f"API調(diào)用失敗: {data.get('msg')}")  

六、注意事項

頻率限制

免費(fèi)版API限制 100次/分鐘，超出需購買配額

數(shù)據(jù)實時性

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

安全建議

在服務(wù)端調(diào)用API，避免App Secret前端暴露

使用HTTPS加密傳輸

調(diào)試工具

利用京東開放平臺的在線調(diào)試器驗證參數(shù)

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

?
審核編輯 黃宇