×

企业级实战：京东商品详情 API 简要说明 + JSON 返回参考

知名用户18007905473 知名用户18007905473 发表于2026-05-18 14:42:02 浏览13 评论0

抢沙发发表评论

前言

一、接口简要说明（企业级）

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：全链路追踪（排错必备）

四、企业级稳定性要点（极简）

  1. QPS 严控：按企业配额限流，用令牌桶平滑流量

  2. 超时 + 重试：5–8s 超时；5xx / 超时指数退避重试（1s/2s/4s，最多 3 次）

  3. 数据强校验：sku_id/title/price 非空；价格 > 0；图片 URL 合法

  4. 多级缓存：本地 Caffeine（10s）+ Redis（3–5min）；空结果缓存 60s

  5. 监控告警：成功率 < 99%、耗时突增、限流、脏数据实时告警


群贤毕至

访客