京东商品评论API接口概述
1. 接口功能
京东商品评论API接口(如item_review
接口)是京东开放平台提供的服务,允许开发者通过HTTP请求获取指定商品的评论数据。该接口支持以下功能:
- 评论内容查询:获取用户对商品的文字评价、评分、图片等。
- 评论属性分析:提取评论的维度(如物流速度、产品质量、性价比等)及用户反馈。
- 分页与筛选:支持按页码、时间范围、评论类型(如追评)等条件查询。
- 商家回复获取:包含商家对用户评论的回复内容。
2. 接口调用流程
- 注册开发者账号:在开放平台注册并创建应用,获取
AppKey
和AppSecret
。 - 构造请求参数:
- 必填参数:
app_key
(应用密钥)、method
(接口名称,如jingdong.comments.list
)、sku_id
(商品ID)、timestamp
(时间戳)、sign
(签名)。 - 可选参数:
page
(页码)、pageSize
(每页数量)、sort
(排序规则)。
- 必填参数:
- 生成签名:使用
AppSecret
对请求参数进行加密,确保请求合法性。 - 发送HTTP请求:通过GET或POST方式调用接口,获取JSON格式的响应数据。
JSON数据示例(测试)
以下是一个模拟的京东商品评论API响应示例,展示接口返回的评论数据结构:
{ | |
"code": 200, | |
"message": "success", | |
"data": { | |
"total": 1234, | |
"page": 1, | |
"pageSize": 10, | |
"comments": [ | |
{ | |
"userId": "user12345", | |
"userName": "张三", | |
"rating": 5, | |
"content": "商品质量很好,物流速度也很快!", | |
"createTime": "2024-12-25 10:00:00", | |
"properties": [ | |
{ "name": "物流速度", "value": "5星" }, | |
{ "name": "产品质量", "value": "5星" } | |
], | |
"pictures": ["https://example.com/pic1.jpg"], | |
"replies": [ | |
{ | |
"replyUserId": "jd_official", | |
"replyContent": "感谢您的支持,我们会继续努力!", | |
"replyTime": "2024-12-26 12:00:00" | |
} | |
], | |
"afterSaleReview": { | |
"content": "使用后效果很好,推荐购买!", | |
"createTime": "2024-12-30 15:00:00" | |
} | |
}, | |
{ | |
"userId": "user67890", | |
"userName": "李四", | |
"rating": 3, | |
"content": "包装有点简陋,但商品本身还可以。", | |
"createTime": "2024-12-24 18:30:00", | |
"properties": [ | |
{ "name": "包装质量", "value": "2星" }, | |
{ "name": "产品质量", "value": "4星" } | |
], | |
"replies": [], | |
"afterSaleReview": null | |
} | |
] | |
} | |
} |
示例说明
- 响应结构
code
:请求状态码(200表示成功)。message
:请求结果描述。data
:包含评论总数、分页信息及评论列表。
- 评论数据字段
userId
/userName
:用户ID与昵称。rating
:用户评分(1-5星)。content
:评论内容。createTime
:评论时间。properties
:评论属性(如物流、质量等)。pictures
:用户上传的图片链接。replies
:商家回复列表。afterSaleReview
:追评内容(若无则为null
)。
- 分页参数
total
:总评论数。page
:当前页码。pageSize
:每页显示的评论数量。