京东API接口系列——京东店铺所有商品数据
京东店铺所有商品API接口核心功能与技术实现
一、核心功能
全量商品数据获取
支持获取指定京东店铺内全部商品信息，涵盖商品ID、名称、品牌、型号、价格（原价/促销价）、库存、销量、评价数、主图URL、详情描述等120+字段。例如，某服装品牌可通过该接口实时监控全店SKU库存状态，优化补货策略。实时数据更新
价格与库存数据实现分钟级同步，确保开发者获取的信息与京东平台一致。某家电品牌通过该功能实现竞品价格监控，当对手调价时自动触发己方价格调整机制。批量查询与分页机制
单次请求支持最多100个SKU查询，配合分页参数（page/pageSize）可高效获取全店商品。某数据服务商通过分页调用，在5分钟内完成百万级商品数据采集。多维度排序与筛选
支持按价格、销量、评价数等字段排序，并可通过sortType参数自定义排序规则。某电商平台利用该功能实现“销量TOP100”榜单实时更新。
二、技术实现要点
接口调用方式
page：页码（默认1）pageSize：每页数量（默认20，最大100）sortType：排序字段（如price、sales）shopId：店铺ID（如“皓顿HAUTTON京东自营旗舰店”的ID为1000081830）app_key/app_secret：应用标识与密钥（需在京东开放平台申请）timestamp：请求时间戳（格式：YYYY-MM-DD HH:MM:SS）请求方法：HTTPS GET/POST
基础URL：
https://api.jd.com/routerjson（官方）或第三方聚合接口（如https://api-gw.onebound.cn/jd/item_search_shop）必填参数：
可选参数：
签名生成机制
采用MD5加密算法，按参数名ASCII码排序后拼接字符串，首尾添加app_secret后生成签名。示例代码：pythonimport hashlibdef generate_sign(params, app_secret):sorted_params = sorted(params.items(), key=lambda x: x[0])sign_str = app_secret + ''.join([f"{k}{v}" for k, v in sorted_params]) + app_secretreturn hashlib.md5(sign_str.encode()).hexdigest().upper()响应数据结构
返回JSON格式数据，核心字段如下：json{"code": "0000", // 状态码（0000表示成功）"total": 1000, // 商品总数"currentPage": 1,"pageSize": 20,"products": [{"productId": "100006965163","productName": "皓顿休闲鞋男鞋头层牛皮时尚潮牌运动小白鞋百搭板鞋子男 9301XB148 白色 38码","price": 368,"stock": 1000,"sales": 5000,"imageUrl": "//img13.360buyimg.com/n7/jfs/t1/153961/17/1801/305679/5f813073E03c570f7/8d5a59f610675771.jpg"}]}
三、应用场景与案例
竞品分析
某美妆品牌通过该接口获取竞品店铺全量商品数据，分析价格分布、促销策略及SKU组合，优化自身产品定价与营销活动。库存监控
某3C配件商家利用分钟级库存更新功能，实时监控爆款商品库存，当库存低于阈值时自动触发补货工单，减少缺货损失。数据中台建设
某大型零售集团通过该接口构建商品数据中台，整合京东、天猫等多平台商品信息，实现全渠道库存共享与动态定价。
四、限制与注意事项
调用频率限制
免费版默认100次/分钟，VIP账号可提升至500次/分钟。需配置IP白名单，避免恶意调用。数据权限要求
部分敏感字段（如销量、评价数）需企业认证或付费权限方可获取。接口稳定性保障
建议实现请求队列与重试机制，应对京东平台限流或网络波动。例如，当返回code=1001（参数错误）时，需检查签名生成逻辑；返回code=2001（系统错误）时，应延迟3秒后重试。
