京東商品評(píng)論 API 接口概述 1. 接口功能 京東商品評(píng)論 API 接口(如 item_review 接口)是京東開放平臺(tái)提供的服務(wù),允許開發(fā)者通過 HTTP 請求獲取指定商品的評(píng)論數(shù)據(jù)。該接口支持以下功能:
評(píng)論內(nèi)容查詢:獲取用戶對(duì)商品的文字評(píng)價(jià)、評(píng)分、圖片等。 評(píng)論屬性分析:提取評(píng)論的維度(如物流速度、產(chǎn)品質(zhì)量、性價(jià)比等)及用戶反饋。 分頁與篩選:支持按頁碼、時(shí)間范圍、評(píng)論類型(如追評(píng))等條件查詢。 商家回復(fù)獲?。喊碳覍?duì)用戶評(píng)論的回復(fù)內(nèi)容。 2. 接口調(diào)用流程
注冊開發(fā)者賬號(hào):在開放平臺(tái)注冊并創(chuàng)建應(yīng)用,獲取 AppKey 和 AppSecret。 構(gòu)造請求參數(shù): 必填參數(shù):app_key(應(yīng)用密鑰)、method(接口名稱,如 jingdong.comments.list)、sku_id(商品 ID)、timestamp(時(shí)間戳)、sign(簽名)。 可選參數(shù):page(頁碼)、pageSize(每頁數(shù)量)、sort(排序規(guī)則)。 生成簽名:使用 AppSecret 對(duì)請求參數(shù)進(jìn)行加密,確保請求合法性。 發(fā)送 HTTP 請求:通過 GET 或 POST 方式調(diào)用接口,獲取 JSON 格式的響應(yīng)數(shù)據(jù)。
JSON 數(shù)據(jù)示例(測試)
以下是一個(gè)模擬的京東商品評(píng)論 API 響應(yīng)示例,展示接口返回的評(píng)論數(shù)據(jù)結(jié)構(gòu):
{
"code": 200,
"message": "success",
"data": {
"total": 1234,
"page": 1,
"pageSize": 10,
"comments": [
{
"userId": "user12345",
"userName": "張三",
"rating": 5,
"content": "商品質(zhì)量很好,物流速度也很快!",
"createTime": "2024-12-25 10:00:00",
"properties": [
{"name": "物流速度", "value": "5 星"},
{"name": "產(chǎn)品質(zhì)量", "value": "5 星"}
],
"pictures": ["https://example.com/pic1.jpg"],
"replies": [
{
"replyUserId": "jd_official",
"replyContent": "感謝您的支持,我們會(huì)繼續(xù)努力!",
"replyTime": "2024-12-26 12:00:00"
}
],
"afterSaleReview": {
"content": "使用后效果很好,推薦購買!",
"createTime": "2024-12-30 15:00:00"
}
},
{
"userId": "user67890",
"userName": "李四",
"rating": 3,
"content": "包裝有點(diǎn)簡陋,但商品本身還可以。",
"createTime": "2024-12-24 18:30:00",
"properties": [
{"name": "包裝質(zhì)量", "value": "2 星"},
{"name": "產(chǎn)品質(zhì)量", "value": "4 星"}
],
"replies": [],
"afterSaleReview": null
}
]
}
}
示例說明
響應(yīng)結(jié)構(gòu)
code:請求狀態(tài)碼(200 表示成功)。
message:請求結(jié)果描述。
data:包含評(píng)論總數(shù)、分頁信息及評(píng)論列表。
評(píng)論數(shù)據(jù)字段
userId/userName:用戶 ID 與昵稱。
rating:用戶評(píng)分(1-5 星)。
content:評(píng)論內(nèi)容。
createTime:評(píng)論時(shí)間。
properties:評(píng)論屬性(如物流、質(zhì)量等)。
pictures:用戶上傳的圖片鏈接。
replies:商家回復(fù)列表。
afterSaleReview:追評(píng)內(nèi)容(若無則為 null)。
分頁參數(shù)
total:總評(píng)論數(shù)。
page:當(dāng)前頁碼。
pageSize:每頁顯示的評(píng)論數(shù)量。