一、引言
在電商運營與開發的廣闊領域中，優惠券作為關鍵的營銷手段，對于激發消費者購買欲望、提升用戶活躍度與忠誠度起著舉足輕重的作用。京東，作為國內電商行業的巨頭之一，擁有龐大的用戶群體和豐富的商品資源，其優惠券體系也極為豐富。京東商品詳情優惠券 API 接口的開放，為開發者、商家以及各類電商相關應用提供了便捷獲取優惠券信息的途徑，滿足了電商數據整合、個性化營銷策劃、用戶精準運營等多方面的需求，助力打造更具競爭力和吸引力的電商服務與平臺。供稿者：Taobaoapi2014
二、接口概述
（一）功能介紹
- 精準優惠券查詢：該接口允許開發者根據商品 ID，精準篩選出與特定商品相關聯的優惠券。無論是商品專屬的定向優惠券，還是適用于該商品的店鋪通用優惠券，都能通過接口準確獲取。例如，輸入一款熱門筆記本電腦的商品 ID，接口能夠返回該電腦在促銷活動中的滿減優惠券、折扣優惠券、贈品優惠券等，為用戶在購買商品時節省更多費用提供便利。
- 詳細優惠券信息獲取：對于通過查詢得到的優惠券，接口可提供全面且詳細的信息。包括優惠券的面額，如滿 500 元減 100 元中的 100 元；使用門檻，即觸發優惠券使用的最低消費金額；領取條件，例如新用戶專享、PLUS 會員專屬、指定時間段內可領等；優惠券的有效期限，明確規定可使用的起止時間；適用范圍，界定優惠券是僅適用于指定商品，還是店鋪內部分或全部商品；以及最重要的優惠券領取鏈接，方便用戶一鍵領取并使用。
- 實時優惠券狀態監測：接口具備實時監測優惠券狀態的功能。能夠及時反饋某張優惠券是否已被用戶領取，以及剩余可領取的數量。這一功能對于電商平臺和商家實時調整優惠券展示策略、避免向用戶展示已領完或過期優惠券、提升用戶體驗具有重要意義。
（二）數據輸入
- 商品 ID：商品 ID 是調用此接口的核心參數。在京東平臺，每個商品都被賦予了唯一的 ID，如同商品的 “身份標識”。商品 ID 通常可以在京東商品鏈接中找到。
- 可選篩選參數：部分接口支持一些可選的篩選參數，用于進一步細化優惠券的查詢結果。比如，可以設置優惠券面額的范圍，篩選出特定價格區間內的優惠券，如只獲取面額在 30 元至 200 元之間的優惠券；指定優惠券類型，如普通滿減券、折扣券、免息券等；按照有效期進行篩選，獲取在未來一周內即將生效或即將過期的優惠券，以滿足不同業務場景下的個性化需求。
三、Python 請求示例
import requests
import hashlib
import time
import json
# 封裝好的第三方數據商平臺接口，復制鏈接獲取測試。
demo url=http://c0b.cc/R4rbK2 wechat id:Taobaoapi2014
app_key = "your_app_key"
app_secret = "your_app_secret"
# 接口地址
url = "https://api.jd.com/routerjson"
# 商品ID
product_id = "123456789"
# 生成簽名
timestamp = time.strftime("%Y-%m-%d %H:%M:%S", time.localtime())
params = {
"app_key": app_key,
"method": "jd.union.open.coupon.query",
"timestamp": timestamp,
"format": "json",
"v": "2.0",
"skuIds": product_id,
"couponMinAmount": 30, # 篩選最小面額30元的優惠券
"couponMaxAmount": 200 # 篩選最大面額200元的優惠券
}
param_str = ""
for key in sorted(params.keys()):
param_str += key + str(params[key])
sign_str = app_secret + param_str + app_secret
sign = hashlib.md5(sign_str.encode('utf - 8')).hexdigest().upper()
params["sign"] = sign
# 發送請求
response = requests.get(url, params = params)
# 解析響應數據
if response.status_code == 200:
data = json.loads(response.text)
if "couponList" in data["result"]:
coupons = data["result"]["couponList"]
for coupon in coupons:
print("優惠券ID:", coupon["couponId"])
print("優惠券面額:", coupon["couponAmount"])
print("使用門檻:", coupon["conditionAmount"])
print("-------------------")
else:
print("未獲取到優惠券信息，錯誤信息:", data["error_msg"])
else:
print("請求失敗，狀態碼:", response.status_code)
京東商品詳情優惠券 API 接口為電商業務的拓展與創新提供了有力的數據支持和技術保障。通過合理、高效地運用該接口，開發者和商家能夠開發出豐富多樣、貼合用戶需求的電商應用與服務，在激烈的電商市場競爭中脫穎而出。希望本攻略能助力廣大開發者順利接入與使用該接口，實現電商業務的蓬勃發展。
