一、接口核心功能‌

‌数据维度‌
支持获取商品标题、实时价格、库存状态、销量、评价数据（评分/评论数）、主图/详情图/视频链接、SKU规格（含价格和库存）、商品属性（如颜色/尺寸）、售后服务条款等120+字段16。

jsonCopy Code
// 简化返回示例（来源实际调用）
{
  "item": {
    "title": "Redmi K60 Pro 5G手机",
    "price": 2999.00,
    "stock": 50,
    "images": ["https://img.jd.com/detail1.jpg"],
    "skuList": [{"skuId": "123456", "name": "墨羽 12GB+256GB", "price": 2999.00}],
    "after_service": {"return_policy": "7天无理由退货"}
  }
}

‌实时性保障‌
    价格与库存数据分钟级更新，依赖长轮询机制15。
    支持批量查询（最多20个SKU）39。

‌二、接入流程‌
‌1. 认证与密钥获取‌

注册京东开放平台企业开发者账号9。
创建应用后申请商品详情API权限，获取AppKey和AppSecret15。

‌2. 请求签名生成‌

签名算法流程：
① 按字典序排序参数（除sign外）
② 拼接参数键值对 → appSecret + 参数字符串 + appSecret
③ 对拼接串进行‌MD5加密‌并转为大写411。

pythonCopy Code

Python签名示例（参考开发者实践）

import hashlib
def generate_sign(params, app_secret):
sorted_params = sorted(params.items())
sign_str = app_secret + ‘’.join(f”{k}{v}” for k,v in sorted_params) + app_secret
return hashlib.md5(sign_str.encode()).hexdigest().upper()

‌三、接口调用实战‌
‌请求示例（Python）‌

pythonCopy Code
import requests
import time

app_key = “YOUR_APP_KEY”
app_secret = “YOUR_APP_SECRET”
sku_id = “123456789”

构造基础参数

params = {
“method”: “jd.union.open.goods.detail.query”,
“app_key”: app_key,
“timestamp”: time.strftime(“%Y-%m-%d %H:%M:%S”),
“v”: “1.0”,
“param_json”: json.dumps({“skuIds”: [sku_id]})
}
params[“sign”] = generate_sign(params, app_secret) # 调用签名函数

发送请求

response = requests.post(“https://api.jd.com/routerjson“, data=params)
data = response.json()

‌关键参数说明‌
参数 必填 说明
method 是 接口方法名，如jingdong.ware.get411
param_json 是 JSON字符串，包含skuIds等查询条件1114
fields 否 指定返回字段，如name,price,stock610
‌四、高频问题与优化‌

‌错误处理‌
    1001：参数缺失 → 检查skuId和timestamp321。
    3005：商品不存在 → 验证SKU有效性3。
    QPS超限：默认频率1000次/分钟，需申请提额或本地缓存数据510。

‌性能优化‌
    ‌缓存策略‌：对静态数据（如商品描述）本地缓存，减少API调用917。
    ‌字段过滤‌：按需请求字段，降低网络负载10。

‌五、应用场景‌
场景 接口价值
比价系统 实时监控竞品价格波动119
库存预警 同步库存数据至ERP系统510
跨境商品本地化 支持12种语言返回1
营销活动生成 自动抓取促销信息（如满减规则）10

‌官方资源‌：

    调试工具：京东开放平台控制台「API调试」模块917
    文档更新：定期检查method命名变动（如ware.get→union.open.goods.query）