## 获取单个商品评价记录列表(goodsComments) >[info] 场景说明:商品详情页,显示商品评价记录信息 ### 是否需要获取用户TOKEN `否` ***** ### 请求地址 ``` POST http://api.xxx.com/goods/comments ``` ### 公共请求参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | appid | string | 必须 | 平台提供的唯一APPID | | version | string | 必须 | 接口版本号,固定填:v3 | | sign\_type | string | 必须 | 签名类型,目前只支持md5 | | timestamp | string | 必须 | 发起时间戳,格式为:yyyy-mm-dd hh::ii::ss | | format | string | 必须 | 返回的数据格式,只支持json | | sign | string | 必须 | 请求参数的签名,请参考:[签名规则](signature.md) | | token | string | 必须 | 访问TOKEN | | params | string | 必须 | 请求参数的集合,除公共参数外,所有请求参数都必须放在这个参数中传递,json\_encode后送入 | 应用请求参数`params`格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | goods\_id | integer | 必须 | 商品ID | | commented | boolean | 可选 | 只取有评价内容的记录,为空或false则不限制 | | level | integer | 可选 | 评价分,3=好评,2=中评,1=差评,如果为空或不传,则不限制 | | page | integer | 可选 | 当前页 | | page\_size | integer | 可选 | 每页读取多少条记录,默认10条 | ### 请求示例 ``` { "appid": "您的APPID", "version": "v3", "sign_type": "md5", "timestamp": "2020-8-10 12:00:00", "format": "json", "sign": "op0987yhjmngt54rtg2wgdfvcder2765", "params": { "goods_id": 1 } } ``` ***** ### 公共返回参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | code | integer | 必须 | 0=成功,其它值代表请求失败的错误代码,请参考:[公共错误码](response-code.md) | | message | string | 必须 | 请求成功/失败的描述信息 | | \+ data | array | 必须 | 返回结果,如果没有数据则返回空 | | └ list | list | 必须 | 评价记录列表 | | └ pagination | array | 必须 | 分页信息 | | └ statistics | array | 必须 | 评价统计信息 | 返回`data->list`参数格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | rec\_id | integer | 必须 | 记录编号 | | goods\_id | integer | 必须 | 商品ID | | goods\_name | string | 必须 | 商品名称 | | spec\_id | integer | 必须 | 规格ID | | buyer\_id | integer | 必须 | 买家ID | | buyer\_name | string | 必须 | 买家用户名 | | buyer\_portrait | string | 必须 | 买家头像 | | specification | string | 必须 | 商品规格集合 | | evaluation | integer | 必须 | 买家给的评分值(0-5分) | | comment | string | 必须 | 买家评价内容 | | evaluation\_time | string | 必须 | 买家评价时间 | | reply\_comment | string | 必须 | 卖家回复评价内容 | | reply\_time | string | 必须 | 卖家回复评价时间 | 返回`data->pagination`参数格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | page | integer | 必须 | 当前页 | | page\_size | integer | 必须 | 每一页显示的数据量 | | page\_count | integer | 必须 | 总页数 | | total | integer | 必须 | 总记录数 | 返回`data->statistics`参数格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | total | integer | 必须 | 该商品总评价数 | | \+ good | array | 必须 | 好评数组 | | └ count | integer | 必须 | 好评数 | | └ percentage | string | 必须 | 好评百分比,如:90% | | \+ middle | array | 必须 | 中评数组 | | └ count | integer | 必须 | 中评数 | | └ percentage | string | 必须 | 中评百分比,如:9% | | \+ bad | array | 必须 | 差评数组 | | └ count | integer | 必须 | 差评数 | | └ percentage | string | 必须 | 差评百分比,如:1% | ### 返回数据示例 ``` { "code": 0, "message": "成功", "data": { "list": [ { "rec_id": 115, "spec_id": 124, "goods_id": 123, "goods_name": "Midea/美的 BCD-213TM(E) 节能静音家用三开门小冰箱小型电冰箱", "buyer_id": 3, "buyer_name": "buyer", "buyer_portrait: "http://www.xxx.com/portrait.jpg", "specification": "颜色:红色", "evaluation":5, "comment": "冰箱很好用", "evaluation_time": "2020-8-10 20:34:44", "reply_comment": "感谢亲们支持", "reply_time": "2020-8-10 22:40:25" }, { "rec_id": 116, "spec_id": 125, "goods_id": 123, "goods_name": "Midea/美的 BCD-213TM(E) 节能静音家用三开门小冰箱小型电冰箱", "buyer_id": 3, "buyer_name": "buyer", "buyer_portrait: "http://www.xxx.com/portrait.jpg", "specification": "颜色:黑色", "evaluation":2, "comment": "冰箱一般", "evaluation_time": "2020-8-10 20:34:44", "reply_comment": "感谢亲们支持", "reply_time": "2020-8-10 22:40:25" } ], "pagination": { "page":1, "page_size":10, "page_count":1, "total":2 }, "statistics": { "total": 2, "good": { "count": 1, "percentage": "50%" }, "middle": { "count": 1, "percentage": "50%" }, "bad": { "count": 0, "percentage": "0%" } } } } ```