京東開(kāi)放平臺(tái)的商品評(píng)論 API（通常為 jd.union.open.goods.comment.query）是獲取商品評(píng)價(jià)數(shù)據(jù)的核心接口，相較于 1688，京東 API 的鑒權(quán)更嚴(yán)格、分頁(yè)規(guī)則更特殊、異常碼體系更規(guī)范，但仍有不少新手易踩的坑。本文從接口基礎(chǔ)信息、核心避坑點(diǎn)維度，給出可落地的開(kāi)發(fā)方案。

一、接口基礎(chǔ)信息（必看）

公共必填參數(shù)

請(qǐng)求地址：c0b.cc/R4rbK2

請(qǐng)求方式：POST（推薦）/ GET

數(shù)據(jù)格式：JSON

核心接口參數(shù)

參數(shù)名 類(lèi)型 必填說(shuō)明

skuIdString 是京東商品 SKU 編號(hào) （核心，如 100012345678）

pageIndexInt 是頁(yè)碼 （從 1 開(kāi)始，單頁(yè)最多返回 100 條，總量通常限制為 1000 條）

pageSizeInt 是每頁(yè)條數(shù) （最大 100，超過(guò)會(huì)被強(qiáng)制改為 100）

scoreInt 否評(píng)分篩選 （0 - 全部，1 - 差評(píng)，2 - 中評(píng)，3 - 好評(píng)，4 - 曬單，5 - 視頻評(píng)價(jià)）

isHasContentInt否是否有文字評(píng)價(jià)（0 - 全部，1 - 有文字）

鑒權(quán)方式：

IP 白名單：生產(chǎn)環(huán)境需將服務(wù)器 IP 加入京東開(kāi)放平臺(tái)白名單，否則直接返回 403。

二、核心避坑點(diǎn)（提前規(guī)避）

分頁(yè)邏輯坑

錯(cuò)誤做法：循環(huán)調(diào)用直到返回空數(shù)據(jù)（平臺(tái)會(huì)在超出 1000 條后返回空列表，但頻繁調(diào)用仍會(huì)觸發(fā)頻控）；

正確做法：提前計(jì)算最大頁(yè)碼（min(總條數(shù)//pageSize + 1, 10)），最多只調(diào)用 10 頁(yè)。

簽名算法坑

錯(cuò)誤做法：參數(shù)未按 ASCII 排序、簽名拼接遺漏 appSecret；

正確做法：嚴(yán)格按京東規(guī)則拼接參數(shù)（key=value&key=value）→ 拼接 appSecret → MD5 加密→ 轉(zhuǎn)大寫(xiě)。

頻控應(yīng)對(duì)坑

錯(cuò)誤做法：短時(shí)間內(nèi)批量拉取多個(gè) SKU 的評(píng)論（極易觸發(fā) QPS 限流）；

正確做法：本地做 QPS 限流（設(shè)為 1.8，預(yù)留余量）+ 批量 SKU 異步分批調(diào)用 + 評(píng)論數(shù)據(jù)本地緩存。

審核編輯 黃宇