一、核心API接口： jd.item.search.shop

功能：通过店铺名称或ID获取店铺内所有商品信息，支持分页、排序及价格区间筛选。
适用场景：商家批量导出商品数据、竞品分析、库存监控等。

二、调用前准备

1. 注册与认证
   • 注册京东开放平台账号，完成企业实名认证。
   • 创建应用，选择“商品API”权限包，提交审核（1-3个工作日）。
   • 审核通过后获取 AppKey和 AppSecret，用于后续签名认证。
2. 安全配置
   • 将 AppSecret存入环境变量或加密数据库（如Vault），避免硬编码泄露。
   • 启用日志监控，记录请求参数、响应状态码及耗时，便于排查问题。

三、API调用实战步骤

1. 生成签名（关键安全步骤）

pythonimport hashlibdef generate_sign(params, app_secret):sorted_params = sorted(params.items())  # 参数按ASCII升序排序param_str = ''.join([f"{k}{v}" for k, v in sorted_params])  # 拼接key=valueparam_str += app_secret  # 拼接AppSecretreturn hashlib.md5(param_str.encode()).hexdigest().upper()  # MD5加密

2. 调用店铺商品接口

pythonimport requestsimport time# 配置参数APP_KEY = "your_app_key"APP_SECRET = "your_app_secret"params = {"method": "jd.item.search.shop","app_key": APP_KEY,"timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),  # 严格格式"v": "2.0","seller_nick": "特步平途专卖店",  # 店铺名称"page": 1,  # 页码"pageSize": 20  # 每页数量}# 生成签名并添加到参数params["sign"] = generate_sign(params, APP_SECRET)# 发送请求response = requests.get("https://api.jd.com/routerjson", params=params)# 解析响应if response.status_code == 200:data = response.json()if data.get('code') == '0':for item in data['result']['items']:print(f"商品名称: {item['title']}, 价格: {item['price']}, 销量: {item['sales']}")else:print(f"Error Code: {data.get('code')}, Message: {data.get('msg')}")else:print(f"HTTP Error: {response.status_code}")

3. 高级参数示例（精准筛选）

pythonparams = {"method": "jd.item.search.shop","app_key": APP_KEY,"timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),"v": "2.0","seller_nick": "皓顿HAUTTON京东自营旗舰店","page": 1,"pageSize": 50,"sortType": "price_asc",  # 按价格升序排序"priceMin": 200,  # 价格下限"priceMax": 500  # 价格上限}

四、响应数据解析

典型响应结构：

json{"code": "0","msg": "success","result": {"items": [{"skuId": "100006965163","title": "皓顿休闲鞋男鞋头层牛皮时尚潮牌运动小白鞋百搭板鞋子男","price": 368,"promotion_price": 368,"pic_url": "//img13.360buyimg.com/n7/jfs/t1/153961/17/1801/305679/5f813073E03c570f7/8d5a59f610675771.jpg","sales": 1200,"seller": "皓顿HAUTTON京东自营旗舰店"}],"total": 120,"page": 1,"pageSize": 20}}

关键字段说明：

• skuId：商品唯一标识符
• title：商品名称
• price：商品价格
• sales：商品销量
• pic_url：商品图片URL

五、常见问题与解决方案

1. 签名错误（Error Code 1001）
   • 原因：参数排序错误、时间戳格式不正确。
   • 解决：检查参数是否按ASCII升序排列，时间戳格式为 YYYY-MM-DD HH:mm:ss。
2. 权限不足（Error Code 1004）
   • 原因：应用未申请商品API权限。
   • 解决：登录开放平台检查权限配置，提交权限升级申请。
3. 店铺名称错误（Error Code 2001）
   • 原因：店铺名称错误或参数不合法。
   • 解决：确认店铺名称正确性，或尝试使用店铺ID（ shopId参数）调用。
4. 触发限流（Error Code 3001）
   • 原因：京东API限流（QPS限制通常为50次/秒）。
   • 解决：使用队列（如Celery）管理请求，或申请提高QPS限额。

六、优化建议

1. 异步处理：批量请求时采用分页机制，结合异步任务（如Python的 asyncio）提高效率。
2. 缓存策略：对不常变动的数据（如分类、品牌）实施本地缓存（如Redis），减少API调用次数。
3. 数据存储：将采集到的数据存储至MySQL数据库，结合可视化工具（如Tableau）完成全链路管理。
4. 错误重试：编写健壮的错误处理逻辑，如指数退避重试机制，应对网络问题或API返回错误。