京东商品API技术对接手册（2025版）

​

一、基础服务能力说明

​​请求性能基准​​

常规接口响应时间≤200ms（95%请求）

建议生产环境配置：
▶ 单实例建议并发≤500 QPS
▶ 突发流量需提前2工作日申请扩容

​​数据覆盖范围​​

支持自营商品90%数据字段

支持商品详情字段查询

​​更新同步机制​​

基础信息：定时任务每小时同步

关键字段实时更新：
▶ 价格变动（延迟≤3秒）
▶ 库存状态（延迟≤15秒）

二、核心接口技术规范

​​商品详情获取

GET /api/product/ 
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/taobao/item_get/?key=< 您自己的apiKey >&secret=< 您自己的apiSecret >&num_iid=652874751412&is_promotion=1"

必返回字段：
▶ Price（京东价）
▶ num（库存状态码）
▶ desc（商品详情图）

​​批量查询接口​​

单次最多100个SKU

错误处理机制：
▶ 部分失败返回错误码E104
▶ 建议重试间隔≥10秒

​​类目树查询​​

包含三级类目结构

特殊标识字段

三、典型业务场景实现

​​价格监控系统​​

建议轮询间隔≥300秒

历史价格查询需单独申请权限

禁用场景：竞品数据采集

​​库存预警模块​​

区域仓数据需指定locationId

预警阈值设置规则：
▶ 总仓库存<1000件触发黄色预警
▶ 所有区域仓库存<100件触发红色预警

​​商品上下架同步​​

状态变更订阅需配置​​​​​​​webhook

异步通知可能延迟2-5分钟

下架原因代码表见附录A

四、开发者注意事项

​​认证鉴权要求​​

AccessKey需绑定服务器出口IP

敏感操作日志强制保存6个月

​​流量控制策略​​

默认配额：5万次/天

超额申请需提供业务场景说明

突发流量缓冲机制：
▶ 允许10%超额持续≤5分钟
▶ 连续超限3次触发账户冷却

​​数据缓存建议​​

静态数据缓存≤24小时

动态字段缓存≤300秒

必须包含"X-Cache-Time"响应头

五、故障排查指引

​​常见错误代码​​

4004：签名校验失败（检查账户正确）

4008：请求超频（检查是否有未捕获的异常请求）

4013：超出限制（建议检查最大请求量级）

​​日志采集规范​​

必须记录完整请求URL

建议记录以下元数据：
▶ 请求耗时
▶ 响应体大小
▶ 服务端traceId

​审核编辑 黄宇