前言
一、接口简要说明（企业级）
1. 核心接口（官方 JOS 开放平台）
- 接口标识：
jingdong.item.read.get（新）/item.jd.get（旧） - 功能：按京东商品 ID（
skuId/itemId）获取全量商品详情（基础、价格、库存、SKU、图片、促销、售后、店铺） - 适用：ERP、商品中台、铺货、价格监控、库存同步（企业 / 商家系统）
- 接入：企业认证 + 店铺授权 + AppKey/AppSecret 签名
- QPS：基础 2 QPS；企业 5–50 QPS
- 格式：默认 JSON，支持 XML
2. 联盟轻量版（推广 / 比价）
- 接口：
jd.union.open.goods.detail.query - 特点：无需店铺授权、含佣金 / 券；库存仅 “有货 / 无货”
3. 核心请求参数（极简）
- skuId / itemId：商品 ID（必传，京东以 SKU 为核心）
- fields：指定返回字段（可选，减少体积）
- access_token：授权凭证（JOS 需）
二、企业级 JSON 返回参考（精简标准结构）
json
{ "code": 200, "message": "success", "result": { "goods_detail_response": { "sku_id": "100012345678", "item_id": "987654321", "title": "2026夏季新款纯棉透气短袖T恤", "sub_title": "舒适亲肤 宽松版型 多色可选", "brand": "XX品牌", "category_path": "服饰内衣>女装>T恤", "price_info": { "original_price": "129.00", "discount_price": "89.00", "promotion_price": "59.00", "currency": "CNY" }, "stock_info": { "stock_num": 320, "is_available": true, "limit_purchase": "限购5件" }, "sales_info": { "sales_count": 8620, "monthly_sales": 2150 }, "image_info": { "main_image": "https://img.jd.com/imgextra/i1/xxx.jpg", "image_list": [ "https://img.jd.com/imgextra/i1/xxx1.jpg", "https://img.jd.com/imgextra/i1/xxx2.jpg" ] }, "sku_list": [ { "sku_id": "10001234567801", "properties": "颜色:白色;尺码:L", "price": "59.00", "stock_num": 85 }, { "sku_id": "10001234567802", "properties": "颜色:黑色;尺码:XL", "price": "59.00", "stock_num": 42 } ], "promotion_info": { "promotions": [ { "type": "满减", "desc": "满199减50", "start_time": "2026-05-01 00:00:00", "end_time": "2026-05-31 23:59:59" } ] }, "shop_info": { "shop_name": "XX服饰旗舰店", "shop_type": "旗舰店", "shop_score": "4.9" }, "after_service": { "return_policy": "7天无理由退货", "warranty": "质保1年" }, "modified": "2026-05-18 09:15:42" } }, "request_id": "jd_req_260518091500123" }
三、关键字段（企业必用）
- sku_id / item_id：商品唯一标识（京东以 SKU 为核心）
- title / sub_title：商品标题 / 副标题
- price_info：原价 / 折扣价 / 促销价（价格同步核心）
- stock_info：库存数量、是否可售（库存同步核心）
- sku_list：多规格（颜色 / 尺码）价格与库存
- image_info：主图 + 详情图（商品展示）
- modified：最后更新时间（增量同步依据）
- request_id：全链路追踪（排错必备）
四、企业级稳定性要点（极简）
- QPS 严控：按企业配额限流，用令牌桶平滑流量
- 超时 + 重试：5–8s 超时；5xx / 超时指数退避重试（1s/2s/4s，最多 3 次）
- 数据强校验：sku_id/title/price 非空；价格 > 0；图片 URL 合法
- 多级缓存：本地 Caffeine（10s）+ Redis（3–5min）；空结果缓存 60s
- 监控告警：成功率 < 99%、耗时突增、限流、脏数据实时告警
