一、接口核心能力与数据结构

京东商品详情API（如 jingdong.ware.get、 jd.union.open.goods.query）返回 标准化JSON数据，覆盖商品全维度信息，典型字段包括：

• 基础信息：商品ID（ num_iid）、标题（ title）、类目路径（ categoryName）、品牌（ brandName）、型号（ model）。
• 价格体系：原价（ original_price）、促销价（ promotionPrice）、折扣比例（ discount）、优惠信息（ couponInfo）。
• 图片资源：主图URL（ pic_url）、详情图列表（ images数组，含多张高清图链接）、视频链接（ videoUrl）。
• 规格参数：SKU属性（颜色、尺寸、材质等）、规格参数表（ specs，如屏幕尺寸、处理器型号）。
• 库存与物流：库存数量（ stock_quantity）、物流政策（ deliveryPolicy）、仓库ID（ warehouseId）。
• 售后保障：退换货政策（ return_policy）、保修期（ warranty）、售后服务条款（ afterMarket）。
• 评价数据：评价总数（ commentCount）、好评率（ goodCommentShare）、差评原因标签（ negativeTags）。

二、实操调用流程（Python示例）

1. 认证与签名生成

pythonimport hashlibimport timeimport requestsdef 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_secretreturn hashlib.md5(sign_str.encode()).hexdigest().upper()app_key = "YOUR_APP_KEY"app_secret = "YOUR_APP_SECRET"timestamp = time.strftime("%Y-%m-%d %H:%M:%S")

2. 构造请求参数

pythonparams = {"method": "jd.union.open.goods.query","app_key": app_key,"timestamp": timestamp,"v": "2.0","sign_method": "md5","param_json": '{"skuIds": "100126351037,100061393554"}'  # 多SKU查询}params["sign"] = generate_sign(params, app_secret)

3. 发送请求与解析响应

pythonurl = "https://api.jd.com/routerjson"response = requests.post(url, data=params)data = response.json()# 解析商品详情for item in data["jd_union_open_goods_query_responce"]["result"]:print(f"商品ID: {item['skuId']}")print(f"标题: {item['skuName']}")print(f"主图: {item['imageUrl']}")print(f"促销价: {item['promotionPrice']}")print(f"库存: {item.get('stock', {}).get('quantity', '无')}")

三、关键返回值示例（JSON片段）

json{"num_iid": "100126351037","title": "京东鲜花爱丽丝泡泡鲜切花","price": 30.9,"original_price": 49.0,"images": ["https://img.jd.com/detail1.jpg","https://img.jd.com/detail2.jpg"],"specs": [{"key": "屏幕尺寸", "value": "6.67英寸"},{"key": "处理器", "value": "骁龙8 Gen2"}],"stock": {"quantity": 50, "status": "有货"},"service": {"return_policy": "7天无理由退货","warranty": "1年官方保修"}}

四、高频场景与注意事项

• 批量查询优化：单次请求支持最多20个SKU，提升数据采集效率。
• 动态数据延迟：价格/库存数据可能存在5-10分钟延迟，重要场景需搭配京东官方数据推送服务。
• 合规性要求：
  • 禁止爬取用户隐私数据（如评价内容需单独申请权限）。
  • 遵守QPS限制（免费版≤2次/秒，企业版可申请提升配额）。
  • 数据用途需符合《京东开放平台服务协议》及数据保护法规。
• 错误处理：
  • 签名错误：检查参数排序及加密逻辑。
  • 参数缺失：核对接口文档必填字段。
  • 调用超限：增加请求间隔或使用缓存。

五、进阶应用方向

• 竞品分析：对比多商品价格、评价、规格参数，生成市场竞争力报告。
• 库存监控：实时追踪热销商品库存，触发补货提醒。
• 用户决策辅助：整合商品详情至小程序/H5页面，提升转化率。
• 数据可视化：用 matplotlib绘制价格趋势图、评价情感分析雷达图（需调用 code_interpreter）。

通过上述流程，开发者可高效获取并解析京东商品详情数据，支撑电商运营、数据分析、系统对接等场景需求。如需处理复杂数据（如批量下载图片、生成可视化图表），可结合 code_interpreter执行Python脚本完成。