京東開放平臺的商品評論 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 異步分批調用 + 評論數據本地緩存。

審核編輯 黃宇