一、引言
在電商運營與開發(fā)的廣闊領(lǐng)域中，優(yōu)惠券作為關(guān)鍵的營銷手段，對于激發(fā)消費者購買欲望、提升用戶活躍度與忠誠度起著舉足輕重的作用。京東，作為國內(nèi)電商行業(yè)的巨頭之一，擁有龐大的用戶群體和豐富的商品資源，其優(yōu)惠券體系也極為豐富。京東商品詳情優(yōu)惠券 API 接口的開放，為開發(fā)者、商家以及各類電商相關(guān)應(yīng)用提供了便捷獲取優(yōu)惠券信息的途徑，滿足了電商數(shù)據(jù)整合、個性化營銷策劃、用戶精準運營等多方面的需求，助力打造更具競爭力和吸引力的電商服務(wù)與平臺。供稿者：Taobaoapi2014
二、接口概述
（一）功能介紹
- 精準優(yōu)惠券查詢：該接口允許開發(fā)者根據(jù)商品 ID，精準篩選出與特定商品相關(guān)聯(lián)的優(yōu)惠券。無論是商品專屬的定向優(yōu)惠券，還是適用于該商品的店鋪通用優(yōu)惠券，都能通過接口準確獲取。例如，輸入一款熱門筆記本電腦的商品 ID，接口能夠返回該電腦在促銷活動中的滿減優(yōu)惠券、折扣優(yōu)惠券、贈品優(yōu)惠券等，為用戶在購買商品時節(jié)省更多費用提供便利。
- 詳細優(yōu)惠券信息獲取：對于通過查詢得到的優(yōu)惠券，接口可提供全面且詳細的信息。包括優(yōu)惠券的面額，如滿 500 元減 100 元中的 100 元；使用門檻，即觸發(fā)優(yōu)惠券使用的最低消費金額；領(lǐng)取條件，例如新用戶專享、PLUS 會員專屬、指定時間段內(nèi)可領(lǐng)等；優(yōu)惠券的有效期限，明確規(guī)定可使用的起止時間；適用范圍，界定優(yōu)惠券是僅適用于指定商品，還是店鋪內(nèi)部分或全部商品；以及最重要的優(yōu)惠券領(lǐng)取鏈接，方便用戶一鍵領(lǐng)取并使用。
- 實時優(yōu)惠券狀態(tài)監(jiān)測：接口具備實時監(jiān)測優(yōu)惠券狀態(tài)的功能。能夠及時反饋某張優(yōu)惠券是否已被用戶領(lǐng)取，以及剩余可領(lǐng)取的數(shù)量。這一功能對于電商平臺和商家實時調(diào)整優(yōu)惠券展示策略、避免向用戶展示已領(lǐng)完或過期優(yōu)惠券、提升用戶體驗具有重要意義。
（二）數(shù)據(jù)輸入
- 商品 ID：商品 ID 是調(diào)用此接口的核心參數(shù)。在京東平臺，每個商品都被賦予了唯一的 ID，如同商品的 “身份標識”。商品 ID 通?？梢栽诰〇|商品鏈接中找到。
- 可選篩選參數(shù)：部分接口支持一些可選的篩選參數(shù)，用于進一步細化優(yōu)惠券的查詢結(jié)果。比如，可以設(shè)置優(yōu)惠券面額的范圍，篩選出特定價格區(qū)間內(nèi)的優(yōu)惠券，如只獲取面額在 30 元至 200 元之間的優(yōu)惠券；指定優(yōu)惠券類型，如普通滿減券、折扣券、免息券等；按照有效期進行篩選，獲取在未來一周內(nèi)即將生效或即將過期的優(yōu)惠券，以滿足不同業(yè)務(wù)場景下的個性化需求。
三、Python 請求示例
import requests
import hashlib
import time
import json
# 封裝好的第三方數(shù)據(jù)商平臺接口，復(fù)制鏈接獲取測試。
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元的優(yōu)惠券
"couponMaxAmount": 200 # 篩選最大面額200元的優(yōu)惠券
}
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
# 發(fā)送請求
response = requests.get(url, params = params)
# 解析響應(yīng)數(shù)據(jù)
if response.status_code == 200:
data = json.loads(response.text)
if "couponList" in data["result"]:
coupons = data["result"]["couponList"]
for coupon in coupons:
print("優(yōu)惠券ID:", coupon["couponId"])
print("優(yōu)惠券面額:", coupon["couponAmount"])
print("使用門檻:", coupon["conditionAmount"])
print("-------------------")
else:
print("未獲取到優(yōu)惠券信息，錯誤信息:", data["error_msg"])
else:
print("請求失敗，狀態(tài)碼:", response.status_code)
京東商品詳情優(yōu)惠券 API 接口為電商業(yè)務(wù)的拓展與創(chuàng)新提供了有力的數(shù)據(jù)支持和技術(shù)保障。通過合理、高效地運用該接口，開發(fā)者和商家能夠開發(fā)出豐富多樣、貼合用戶需求的電商應(yīng)用與服務(wù)，在激烈的電商市場競爭中脫穎而出。希望本攻略能助力廣大開發(fā)者順利接入與使用該接口，實現(xiàn)電商業(yè)務(wù)的蓬勃發(fā)展。
