摘要
在电商竞品监控、比价系统、商品信息中台开发场景中，京东商品基础信息、价格、规格、库存、图片、类目等数据是核心数据源。很多项目初期选择网页爬虫抓取商品详情，但页面经常改版、JS 动态渲染、防盗链、IP 风控等问题带来极高维护成本。本文基于京东开放平台宙斯体系商品详情接口，讲解接口基础规范、请求入参、返回结构，附带标准 JSON 返回样例，梳理字段解析要点、开发踩坑、业务落地场景，提供合规稳定的官方接口落地方案。
1. 接口基础信息
jd .item_get（京东淘商品详情 API），输入参数为商品唯一 ID num_iid，返回完整商品详情结构化 JSON 数据。
接口简介
接口名称：jd.item_get（京东商品详情API，taobaoapi2014前往体验）
接口版本：2.0
调用限制：存在单秒频次、每日调用配额，高频场景需做限流、缓存 处理。
核心作用：根据商品 ID，获取商品标题、价格、SKU、库存、图文、类 目、销量、规格属性等全量详情数据。
接口能力覆盖
商品基础元数据：标题、售价、划线价、销量、库存、发货地
多媒体资源：主图、轮播图、HTML 详情描述
SKU 规格集合：多规格价格、库存、规格文本
商品属性参数：材质、尺码、品牌等类目属性
店铺信息：店铺 ID、店铺昵称、店铺类型
营销促销信息：活动价、优惠券标签
2. 请求入参说明
参数名是否必传说明app_key是京东开放平台应用密钥，创建应用获取method是接口方法名timestamp是13 位毫秒时间戳v是协议版本，一般 2.0sign_method是签名算法：sha256sign是参数排序后加密生成的签名串access_token否授权令牌，部分接口需要skuIds是商品 SKU 编号，支持批量传入多个 SKUfields否按需指定返回字段，减少返回包大小，提升接口响应速度
3. 返回核心字段说明
字段数据类型说明开发注意事项skuIdstring商品 SKU 编号最小销售单元 ID，主键titlestring商品完整标题用于检索、展示shortTitlestring短标题列表展示用saleStateint上下架状态1 上架，0 下架，下架商品部分字段为空priceInfoobject价格对象包含市场价、京东售价、促销价、优惠券信息imageInfoobject图片集合主图、轮播图数组，图片链接有防盗链brandobject品牌信息brandId、brandName、品牌 logocategoryobject类目信息一级 / 二级 / 三级类目 ID 与名称skuListarray多规格 SKU 数组一个 SPU 对应多个 SKU，颜色、版本、容量区分stockInfoobject库存信息可用库存、是否可售、限购、预售标识salesInfoobject销量评价数据总销量、月销、评价总数、好评率shopInfoobject店铺信息店铺 ID、店铺名称、是否京东自营paramListarray商品规格参数材质、尺寸、产地等属性键值对
4. 调用流程简述
在京东开放平台创建应用，申请对应接口权限；
组装公共参数与业务参数，参数按规则排序，SHA256 生成 sign 签名；
传入 skuIds，配置需要的 fields，发起 POST 请求；
解析返回 JSON，循环遍历goodsInfoList，读取各 SKU 详情；
skuId 作为唯一主键，入库存储，用于增量同步；
业务侧：比价监控、商品中台、竞品信息采集。
