?

在電商平臺(tái)開(kāi)發(fā)或數(shù)據(jù)分析中，經(jīng)常需要獲取商品的實(shí)時(shí)價(jià)格信息，尤其是包含優(yōu)惠券抵扣后的最終價(jià)格（券后價(jià)）。京東平臺(tái)提供了豐富的API接口供開(kāi)發(fā)者使用。本文將簡(jiǎn)要介紹如何調(diào)用京東的API來(lái)獲取商品的券后價(jià)格詳情。

核心概念

商品ID (skuId): 京東平臺(tái)為每個(gè)商品分配的唯一標(biāo)識(shí)符，是查詢(xún)商品信息的關(guān)鍵。

優(yōu)惠券ID (couponId): 京東平臺(tái)發(fā)放的各種優(yōu)惠券的唯一標(biāo)識(shí)符。不同券有不同的使用規(guī)則和面額。

券后價(jià): 商品原價(jià)減去適用的優(yōu)惠券抵扣金額后的最終成交價(jià)。

API調(diào)用流程概述

調(diào)用API獲取券后價(jià)通常涉及以下幾個(gè)步驟：

身份認(rèn)證 (Authentication): 大多數(shù)京東API需要有效的訪(fǎng)問(wèn)令牌才能調(diào)用。通常使用OAuth 2.0等協(xié)議進(jìn)行授權(quán)。

構(gòu)造請(qǐng)求 (Request Construction):

確定目標(biāo)API的端點(diǎn)URL。

設(shè)置必要的請(qǐng)求頭，如 Authorization: Bearer 。

在請(qǐng)求體或查詢(xún)參數(shù)中包含目標(biāo)商品的 skuId 和想要查詢(xún)的 couponId（如果已知特定券）。

發(fā)送請(qǐng)求 (Send Request): 使用HTTP客戶(hù)端庫(kù)發(fā)送請(qǐng)求。

解析響應(yīng) (Parse Response): 處理返回的數(shù)據(jù)（通常是JSON格式），提取所需的券后價(jià)格信息。

示例請(qǐng)求與響應(yīng)

假設(shè)的API端點(diǎn)

https://api.jd.com/routerjson (實(shí)際接口地址請(qǐng)參考京東官方文檔)

請(qǐng)求參數(shù)示例 (簡(jiǎn)化的示意)

{
  "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", // 目標(biāo)商品ID
  "couponId": "COUPON-ABCD-1234" // 目標(biāo)優(yōu)惠券ID (可選)
}

app_key, access_token, timestamp, v, sign 是京東API通用的認(rèn)證和簽名參數(shù)。

skuId 指定要查詢(xún)的商品。

couponId 可選，指定要計(jì)算價(jià)格的特定優(yōu)惠券。如果不提供，API可能會(huì)返回該商品所有可用券對(duì)應(yīng)的券后價(jià)。

響應(yīng)示例 (簡(jiǎn)化的示意)

{
  "code": 0, // 0 表示成功
  "message": "Success",
  "data": {
    "skuId": "1234567890",
    "originalPrice": 299.00, // 商品原價(jià)
    "coupons": [
      {
        "couponId": "COUPON-ABCD-1234",
        "couponName": "滿(mǎn)199減50",
        "discount": 50.00, // 優(yōu)惠券面額
        "couponPrice": 249.00 // 使用此券后的券后價(jià)
      },
      {
        "couponId": "COUPON-EFGH-5678",
        "couponName": "新用戶(hù)專(zhuān)享立減20",
        "discount": 20.00,
        "couponPrice": 279.00
      }
    ]
  }
}

originalPrice 是商品的原價(jià)。

coupons 數(shù)組列出了該商品可用的優(yōu)惠券及其對(duì)應(yīng)的券后價(jià) (couponPrice)。

示例代碼 (Python)

import requests
import json
import time
import hashlib

# 替換為你的實(shí)際信息
APP_KEY = "YOUR_APP_KEY"
APP_SECRET = "YOUR_APP_SECRET"
ACCESS_TOKEN = "YOUR_ACCESS_TOKEN" # 通常通過(guò)OAuth流程獲取
SKU_ID = "1234567890" # 目標(biāo)商品ID
# COUPON_ID = "SPECIFIC_COUPON_ID" # 可選，指定券ID

def generate_sign(params, app_secret):
    """生成請(qǐng)求簽名 (示意邏輯，實(shí)際規(guī)則需參照京東文檔)"""
    # 1. 參數(shù)排序
    sorted_keys = sorted(params.keys())
    # 2. 拼接鍵值對(duì)
    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()

# 基礎(chǔ)參數(shù)
base_params = {
    "method": "jingdong.price.getCouponPrice", # 假設(shè)的方法名
    "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)

# 發(fā)送請(qǐng)求 (假設(shè)是POST請(qǐng)求)
url = "https://api.jd.com/routerjson"
response = requests.post(url, data=base_params)

# 處理響應(yīng)
if response.status_code == 200:
    resp_data = response.json()
    if resp_data.get("code") == 0: # 成功
        data = resp_data["data"]
        print(f"商品ID: {data['skuId']}, 原價(jià): ￥{data['originalPrice']:.2f}")
        for coupon in data["coupons"]:
            print(f"  優(yōu)惠券: {coupon['couponName']} (ID: {coupon['couponId']})")
            print(f"    面額: ￥{coupon['discount']:.2f}, 券后價(jià): ￥{coupon['couponPrice']:.2f}")
    else:
        print(f"API調(diào)用失敗! 錯(cuò)誤碼: {resp_data['code']}, 信息: {resp_data['message']}")
else:
    print(f"HTTP請(qǐng)求失敗! 狀態(tài)碼: {response.status_code}")

注意事項(xiàng)

官方文檔: 務(wù)必查閱京東官方提供的最新API文檔，確認(rèn)確切的接口名稱(chēng)、請(qǐng)求參數(shù)、響應(yīng)格式、認(rèn)證方式和簽名生成規(guī)則。接口和參數(shù)可能會(huì)更新。

權(quán)限申請(qǐng): 使用京東API通常需要注冊(cè)成為開(kāi)發(fā)者并創(chuàng)建應(yīng)用，申請(qǐng)相應(yīng)的API調(diào)用權(quán)限。

頻率限制: 注意API的調(diào)用頻率限制，避免因頻繁請(qǐng)求被限制或封禁。

錯(cuò)誤處理: 在代碼中妥善處理各種可能的錯(cuò)誤（網(wǎng)絡(luò)錯(cuò)誤、API返回錯(cuò)誤、數(shù)據(jù)解析錯(cuò)誤等）。

數(shù)據(jù)時(shí)效性: 券后價(jià)信息可能隨時(shí)變動(dòng)（如優(yōu)惠券過(guò)期、庫(kù)存變化），獲取的數(shù)據(jù)僅代表調(diào)用時(shí)刻的狀態(tài)。

安全性: 妥善保管你的 APP_KEY 和 APP_SECRET，不要泄露。

通過(guò)調(diào)用京東提供的API，開(kāi)發(fā)者可以高效地獲取商品的券后價(jià)格信息，為價(jià)格監(jiān)控、優(yōu)惠分析、比價(jià)工具等應(yīng)用提供數(shù)據(jù)支持。

?審核編輯 黃宇