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