企业级实战：京东商品详情 API 简要说明 + JSON 返回参考
前言
一、接口简要说明（企业级）
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 返回参考（精简标准结构）
"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%、耗时突增、限流、脏数据实时告警
