当前位置：首页 > news >正文

如何通过API获取京东商品的券后价格详情

news 2026/5/12 18:56:04

在电商平台开发或数据分析中，经常需要获取商品的实时价格信息，尤其是包含优惠券抵扣后的最终价格（券后价）。京东平台提供了丰富的API接口供开发者使用。本文将简要介绍如何调用京东的API来获取商品的券后价格详情。

核心概念

商品ID (skuId): 京东平台为每个商品分配的唯一标识符，是查询商品信息的关键。
优惠券ID (couponId): 京东平台发放的各种优惠券的唯一标识符。不同券有不同的使用规则和面额。
券后价: 商品原价减去适用的优惠券抵扣金额后的最终成交价。

API调用流程概述

调用API获取券后价通常涉及以下几个步骤：

身份认证 (Authentication): 大多数京东API需要有效的访问令牌才能调用。通常使用OAuth 2.0等协议进行授权。
构造请求 (Request Construction):
- 确定目标API的端点URL。
- 设置必要的请求头，如Authorization: Bearer <your_access_token>。
- 在请求体或查询参数中包含目标商品的skuId和想要查询的couponId（如果已知特定券）。
发送请求 (Send Request): 使用HTTP客户端库发送请求。
解析响应 (Parse Response): 处理返回的数据（通常是JSON格式），提取所需的券后价格信息。

示例请求与响应

假设的API端点

https://api.jd.com/routerjson(实际接口地址请参考京东官方文档)

请求参数示例 (简化的示意)

{ "method": "jingdong.price.getCouponPrice", "app_key": "YOUR_APP_KEY", "access_token": "YOUR_ACCESS_TOKEN", "timestamp": "2023-10-27 10:00:00", "v": "2.0", "sign": "GENERATED_SIGNATURE", "skuId": "1234567890", // 目标商品ID "couponId": "COUPON-ABCD-1234" // 目标优惠券ID (可选) }

app_key,access_token,timestamp,v,sign是京东API通用的认证和签名参数。
skuId指定要查询的商品。
couponId可选，指定要计算价格的特定优惠券。如果不提供，API可能会返回该商品所有可用券对应的券后价。

响应示例 (简化的示意)

{ "code": 0, // 0 表示成功 "message": "Success", "data": { "skuId": "1234567890", "originalPrice": 299.00, // 商品原价 "coupons": [ { "couponId": "COUPON-ABCD-1234", "couponName": "满199减50", "discount": 50.00, // 优惠券面额 "couponPrice": 249.00 // 使用此券后的券后价 }, { "couponId": "COUPON-EFGH-5678", "couponName": "新用户专享立减20", "discount": 20.00, "couponPrice": 279.00 } ] } }

originalPrice是商品的原价。
coupons数组列出了该商品可用的优惠券及其对应的券后价 (couponPrice)。

示例代码 (Python)

import requests import json import time import hashlib # 替换为你的实际信息 APP_KEY = "YOUR_APP_KEY" APP_SECRET = "YOUR_APP_SECRET" ACCESS_TOKEN = "YOUR_ACCESS_TOKEN" # 通常通过OAuth流程获取 SKU_ID = "1234567890" # 目标商品ID # COUPON_ID = "SPECIFIC_COUPON_ID" # 可选，指定券ID def generate_sign(params, app_secret): """生成请求签名 (示意逻辑，实际规则需参照京东文档)""" # 1. 参数排序 sorted_keys = sorted(params.keys()) # 2. 拼接键值对 param_str = app_secret for key in sorted_keys: param_str += key + params[key] param_str += app_secret # 3. MD5签名 (示例) return hashlib.md5(param_str.encode('utf-8')).hexdigest().upper() # 基础参数 base_params = { "method": "jingdong.price.getCouponPrice", # 假设的方法名 "app_key": APP_KEY, "access_token": ACCESS_TOKEN, "timestamp": time.strftime("%Y-%m-%d %H:%M:%S", time.localtime()), "v": "2.0", "skuId": SKU_ID, # "couponId": COUPON_ID # 如果需要指定券，取消注释 } # 生成签名 base_params["sign"] = generate_sign(base_params, APP_SECRET) # 发送请求 (假设是POST请求) url = "https://api.jd.com/routerjson" response = requests.post(url, data=base_params) # 处理响应 if response.status_code == 200: resp_data = response.json() if resp_data.get("code") == 0: # 成功 data = resp_data["data"] print(f"商品ID: {data['skuId']}, 原价: ¥{data['originalPrice']:.2f}") for coupon in data["coupons"]: print(f" 优惠券: {coupon['couponName']} (ID: {coupon['couponId']})") print(f" 面额: ¥{coupon['discount']:.2f}, 券后价: ¥{coupon['couponPrice']:.2f}") else: print(f"API调用失败! 错误码: {resp_data['code']}, 信息: {resp_data['message']}") else: print(f"HTTP请求失败! 状态码: {response.status_code}")