接口描述:

  • 获取商品评价列表。

请求 URL:

  • http|https://host/api/v1/goods_comment/method/get.goods.comment.list/

请求方式:

  • GET
  • POST

是否授权:

业务参数:

参数名 类型 是否必须 范围值 默认值 示例值 描述
goods_id integer gt:0 89 商品编号
type integer in:0,2 0 2 商品评价类型 0=主评 2=追评
score integer between:0,2 2 商品评价得分 0=好评 1=中评 2=差评
is_image integer in:0,1 1 是否有图 0=否 1=是
goods_spec array min[]:0 ["1_3","1_2"] 商品规格
page_no integer gt:0 1 1 页码
page_size integer between:1,40 15 15 每页数量
order_type string in:asc,desc desc asc 排序方式
order_field string 见附属 A goods_comment_id status 排序字段

附属 A:
in:goods_comment_id,is_image,score,is_show,is_top,status,create_time

响应参数:

参数名 类型 是否返回 示例值 描述
status integer 200 状态码
message string success 消息信息
data object [] 返回对象
data 类型 是否返回 示例值 描述
items array [] 列表项
total_result integer 1 合计计数
items 类型 是否返回 示例值 描述
goods_comment_id integer 1 商品评价编号
type integer 0 商品评价类型 0=主评 1=主回 2=追评 3=追回
content string 主评内容 商品评价内容
image array ["//image_1.jpg"] 商品评价图片
score integer 5 商品评价得分
praise integer 10 商品评价点赞数
reply_count integer 0 商品评价回复数
ip_address string 127.0.0.1 评价者ip地址
create_time datetime 2018-05-10 23:29:42 创建时间
get_user object [] 账号数组
get_goods object [] 订单商品数组
get_user 类型 是否返回 示例值 描述
username string carey 账号
nickname string careya 昵称
user_level_id integer 2 账号等级编号
head_pic string //head_pic.jpg 头像
get_goods 类型 是否返回 示例值 描述
goods_id integer 89 商品编号
goods_name string 订单商品 商品名称
goods_image string //image.jpg 商品封面
key_value string 规格A 商品规格

响应示例:

  1. {
  2. "status": 200,
  3. "message": "success",
  4. "data": {
  5. "items": [
  6. {
  7. "goods_comment_id": 1,
  8. "type": 0,
  9. "content": "主评内容",
  10. "image": [
  11. "//image_1.jpg",
  12. "//image_2.jpg"
  13. ],
  14. "score": 5,
  15. "praise": 10,
  16. "reply_count": 0,
  17. "ip_address": "127.0.0.1",
  18. "create_time": "2018-05-10 23:29:42",
  19. "get_user": {
  20. "username": "carey",
  21. "nickname": "careya",
  22. "user_level_id": 2,
  23. "head_pic": "//head_pic.jpg"
  24. },
  25. "get_goods": {
  26. "goods_id": 89,
  27. "goods_name": "订单商品",
  28. "goods_image": "//image.jpg",
  29. "key_value": "规格A"
  30. }
  31. }
  32. ],
  33. "total_result": 1
  34. }
  35. }

备注:

  1. 该接口支持条件搜索,如果不带入业务参数则使用默认值。

  2. 如果传入goods_id参数,则会返回get_main_reply get_addition get_addition_reply字段,含义可参考 获取某个评价的明细

文档更新时间: 2018-06-21 01:11