京东商品评论API开发指南（避坑 + 实战）

京东开放平台的商品评论 API（通常为 jd.union.open.goods.comment.query）是获取商品评价数据的核心接口，相较于 1688，京东 API 的鉴权更严格、分页规则更特殊、异常码体系更规范，但仍有不少新手易踩的坑。本文从接口基础信息、核心避坑点维度，给出可落地的开发方案。

一、接口基础信息（必看）

1. 公共必填参数

请求地址：c0b.cc/R4rbK2（Taobaoapi2014 获取体验）

请求方式：POST（推荐）/ GET

数据格式：JSON

2. 核心接口参数

参数名      类型      必填说明

skuIdString    是京东商品 SKU 编号    （核心，如 100012345678）

pageIndexInt        是页码    （从 1 开始，单页最多返回 100 条，总量通常限制为 1000 条）

pageSizeInt      是每页条数   （最大 100，超过会被强制改为 100）

scoreInt    否评分筛选   （0 - 全部，1 - 差评，2 - 中评，3 - 好评，4 - 晒单，5 - 视频评价）

isHasContentInt否是否有文字评价（0 - 全部，1 - 有文字）

鉴权方式：

IP 白名单：生产环境需将服务器 IP 加入京东开放平台白名单，否则直接返回 403。

二、核心避坑点（提前规避）

1. 分页逻辑坑

 错误做法：循环调用直到返回空数据（平台会在超出 1000 条后返回空列表，但频繁调用仍会触发频控）；

正确做法：提前计算最大页码（min(总条数//pageSize + 1, 10)），最多只调用 10 页。

2. 签名算法坑

 错误做法：参数未按 ASCII 排序、签名拼接遗漏 appSecret；

正确做法：严格按京东规则拼接参数（key=value&key=value）→ 拼接 appSecret → MD5 加密→ 转大写。

3. 频控应对坑

错误做法：短时间内批量拉取多个 SKU 的评论（极易触发 QPS 限流）；

 正确做法：本地做 QPS 限流（设为 1.8，预留余量）+ 批量 SKU 异步分批调用 + 评论数据本地缓存。