京东商品评论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:每页显示的评论数量。
