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