京东商品详情API接口调用技术指南‌

news2025/4/26 3:19:05

本文基于京东宙斯开放平台（JD Open API）的 jingdong.ware.product.detail.search.get 接口，提供商品详情数据获取的完整技术方案，包含参数说明、代码实现及实战避坑指南。

一、接口功能与权限‌

核心能力‌

获取商品SKU的完整信息，包括标题、价格、库存、促销活动、主图、详情页描述等；
支持批量查询（最多50个SKU/次）及多维度字段筛选；
返回数据包含京东自营与第三方店铺商品（需权限覆盖）。

权限要求‌

注册京东宙斯开发者账号，创建应用并申请商品详情读取权限；
需完成企业资质认证（个人开发者权限受限）。
二、接口参数说明‌
参数‌    ‌类型‌    ‌必填‌    ‌描述‌
method    String    是    固定值：jingdong.ware.product.detail.search.get
sku_ids    String    是    商品SKU列表，多个ID用英文逗号分隔（如 12345,67890）
fields    String    否    指定返回字段（默认全量），如 wareId,title,price,imagePath
access_token    String    是    OAuth2.0令牌，通过授权流程获取（有效期24小时）
app_key    String    是    应用身份标识，从开放平台控制台获取
timestamp    String    是    请求时间戳（格式 yyyy-MM-dd HH:mm:ss），服务端校验时效性
三、Python代码示例（OAuth2.0 + 签名）‌
python
Copy Code
import requests
import hashlib
import time
from urllib.parse import quote

# 配置参数
app_key = "YOUR_APP_KEY"
app_secret = "YOUR_APP_SECRET"
sku_ids = "12345,67890" # 示例SKU
access_token = "YOUR_ACCESS_TOKEN"

# 生成签名
def jd_sign(params):
    sorted_params = sorted(params.items(), key=lambda x: x[0])
    param_str = app_secret + ''.join([f"{k}{v}" for k, v in sorted_params]) + app_secret
    return hashlib.md5(param_str.encode()).hexdigest().upper()

# 请求商品详情
def fetch_jd_product_detail():
    base_url = "https://api.jd.com/routerjson"
    timestamp = time.strftime("%Y-%m-%d %H:%M:%S", time.localtime())

    params = {
        "method": "jingdong.ware.product.detail.search.get",
        "sku_ids": sku_ids,
        "fields": "wareId,title,price,imagePath,stock",
        "access_token": access_token,
        "app_key": app_key,
        "timestamp": timestamp,
        "v": "2.0",
        "format": "json"
    }

    # 生成签名并编码
    params["sign"] = jd_sign(params)
    encoded_params = {k: quote(str(v)) for k, v in params.items()}

    response = requests.get(base_url, params=encoded_params)
    return response.json()

# 示例调用
data = fetch_jd_product_detail()
print(data)

代码解析‌：

签名规则‌：拼接 app_secret + 有序参数键值对 + app_secret 生成MD5签名，确保请求合法性；
URL编码‌：所有参数值使用 urllib.parse.quote 处理，避免特殊字符导致请求失败；
数据解析‌：响应为JSON格式，商品信息存储在 result 字段中（需校验 code 状态码）。
四、响应数据结构示例‌
json
Copy Code
{
"code": "0",
"message": "Success",
"result": [
    {
      "wareId": "12345",
      "title": "京东自营商品标题示例",
      "price": "299.00",
      "stock": 100,
      "imagePath": "https://img14.360buyimg.com/n1/jfs/t1/xxx.jpg"
    },
    {
      "wareId": "67890",
      "title": "第三方店铺商品示例",
      "price": "159.00",
      "stock": 0,
      "imagePath": "https://img14.360buyimg.com/n1/jfs/t1/yyy.jpg"
    }
]
}