一、引言
在电商运营与开发的广阔领域中，优惠券作为关键的营销手段，对于激发消费者购买欲望、提升用户活跃度与忠诚度起着举足轻重的作用。京东，作为国内电商行业的巨头之一，拥有庞大的用户群体和丰富的商品资源，其优惠券体系也极为丰富。京东商品详情优惠券 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 接口为电商业务的拓展与创新提供了有力的数据支持和技术保障。通过合理、高效地运用该接口，开发者和商家能够开发出丰富多样、贴合用户需求的电商应用与服务，在激烈的电商市场竞争中脱颖而出。希望本攻略能助力广大开发者顺利接入与使用该接口，实现电商业务的蓬勃发展。
