?

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

一、API概述

京東券后價(jià)API屬于京東宙斯開(kāi)放平臺(tái)的一部分，主要用于：

查詢單個(gè)或多個(gè)商品的券后價(jià)格

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

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

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

比價(jià)插件開(kāi)發(fā)

購(gòu)物車價(jià)格實(shí)時(shí)更新

營(yíng)銷活動(dòng)頁(yè)面展示

二、準(zhǔn)備工作

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

注冊(cè)開(kāi)發(fā)者賬號(hào)

訪問(wèn)京東宙斯開(kāi)放平臺(tái)

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

申請(qǐng)API權(quán)限

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

環(huán)境配置

確保開(kāi)發(fā)環(huán)境支持HTTPS請(qǐng)求

安裝必要庫(kù)（如Python的requests庫(kù)）

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

請(qǐng)求方式

HTTP方法: GET

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

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

核心請(qǐng)求參數(shù)

簽名生成規(guī)則

簽名sign的計(jì)算公式：

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

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

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

計(jì)算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)鍵字段說(shuō)明

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

original_price: 商品原價(jià)

coupon_price: 券后實(shí)際價(jià)格

discount: 優(yōu)惠金額

錯(cuò)誤處理

code != 0時(shí)檢查msg字段，常見(jiàn)錯(cuò)誤：

1001: 參數(shù)缺失

2002: 簽名驗(yàn)證失敗

3005: 商品不存在

五、Python示例代碼

以下代碼演示如何調(diào)用券后價(jià)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ā)送請(qǐng)求  
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']}, 券后價(jià): ￥{item['coupon_price']}")  
else:  
    print(f"API調(diào)用失敗: {data.get('msg')}")  

六、注意事項(xiàng)

頻率限制

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

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

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

安全建議

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

使用HTTPS加密傳輸

調(diào)試工具

利用京東開(kāi)放平臺(tái)的在線調(diào)試器驗(yàn)證參數(shù)

通過(guò)本指南，您可快速集成京東券后價(jià)功能。如有任何疑問(wèn)，歡迎大家留言探討。

?
審核編輯 黃宇