京东开放平台的商品评论 API（通常为 jd.union.open.goods.comment.query）是获取商品评价数据的核心接口，相较于 1688，京东 API 的鉴权更严格、分页规则更特殊、异常码体系更规范，但仍有不少新手易踩的坑。本文从接口基础信息、核心避坑点维度，给出可落地的开发方案。
一、接口基础信息（必看）
- 公共必填参数
请求地址：c0b.cc/R4rbK2
请求方式：POST（推荐）/ GET
数据格式：JSON
- 核心接口参数
参数名 类型 必填说明
skuIdString 是京东商品 SKU 编号 （核心，如 100012345678）
pageIndexInt 是页码 （从 1 开始，单页最多返回 100 条，总量通常限制为 1000 条）
pageSizeInt 是每页条数 （最大 100，超过会被强制改为 100）
scoreInt 否评分筛选 （0 - 全部，1 - 差评，2 - 中评，3 - 好评，4 - 晒单，5 - 视频评价）
isHasContentInt否是否有文字评价（0 - 全部，1 - 有文字）
鉴权方式：
IP 白名单：生产环境需将服务器 IP 加入京东开放平台白名单，否则直接返回 403。
二、核心避坑点（提前规避）
分页逻辑坑
错误做法：循环调用直到返回空数据（平台会在超出 1000 条后返回空列表，但频繁调用仍会触发频控）；
正确做法：提前计算最大页码（min(总条数//pageSize + 1, 10)），最多只调用 10 页。
签名算法坑
错误做法：参数未按 ASCII 排序、签名拼接遗漏 appSecret；
正确做法：严格按京东规则拼接参数（key=value&key=value）→ 拼接 appSecret → MD5 加密→ 转大写。
- 频控应对坑
错误做法：短时间内批量拉取多个 SKU 的评论（极易触发 QPS 限流）；
正确做法：本地做 QPS 限流（设为 1.8，预留余量）+ 批量 SKU 异步分批调用 + 评论数据本地缓存。
