接口描述:

  • 获取商品咨询列表。

请求 URL:

  • http|https://host/api/v1/goods_consult/method/get.goods.consult.list/

请求方式:

  • GET
  • POST

是否授权:

  • 需要授权

业务参数:

参数名 类型 是否必须 范围值 默认值 示例值 描述
goods_id integer egt:0 0 0 商品编号
content string max:200 问答搜索 商品咨询或回复
is_show integer in:0,1 1 前台是否显示 0=否 1=是
type integer between:-128,127 5 商品咨询类型(自定义)
status integer in:0,1 0 是否回复 0=待回复 1=已回复
is_answer integer in:0,1 0 1 是否显示完整问答列表 0=否 1=是
account string max:60 carey 账号或昵称
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_consult_id status 排序字段

附属 A:
in:goods_consult_id,type,content,is_show,is_anon,status,create_time,username,nickname

响应参数:

参数名 类型 是否返回 示例值 描述
status integer 200 状态码
message string success 消息信息
data object [] 返回对象
data 类型 是否返回 示例值 描述
items array [] 列表项
total_result integer 2 合计计数
items 类型 是否返回 示例值 描述
goods_consult_id integer 13 商品咨询编号
type integer 5 商品咨询类型(自定义)
content string 咨询内容 商品咨询内容
is_show integer 0 前台是否显示 0=否 1=是
status integer 1 是否回复 0=待回复 1=已回复
create_time datetime 2017-04-10 16:29:29 创建时间
get_user object [] 账号对象
get_goods object [] 商品对象
get_answer array [] 回复数组
get_user 类型 是否返回 示例值 描述
username string carey 账号
nickname string careya 昵称
head_pic string //head_pic.jpg 头像
get_goods 类型 是否返回 示例值 描述
goods_id integer 1 商品编号
name string 编辑一个商品 商品名称
attachment array [] 商品附件(图册)
get_answer 类型 是否返回 示例值 描述
goods_consult_id integer 16 商品咨询编号
type integer 5 商品咨询类型(自定义)
content string 回复内容 商品回复内容
create_time datetime 2017-04-10 16:29:29 创建时间

响应示例:

  1. {
  2. "status": 200,
  3. "message": "success",
  4. "data": {
  5. "items": [
  6. {
  7. "goods_consult_id": 13,
  8. "type": 5,
  9. "content": "咨询内容",
  10. "is_show": 0,
  11. "status": 1,
  12. "create_time": "2017-04-10 16:29:29",
  13. "get_user": {
  14. "username": "carey",
  15. "nickname": "careya",
  16. "head_pic": "//head_pic.jpg"
  17. },
  18. "get_goods": {
  19. "goods_id": 1,
  20. "name": "编辑一个商品",
  21. "attachment": []
  22. },
  23. "get_answer": [
  24. {
  25. "goods_consult_id": 16,
  26. "type": 5,
  27. "content": "回复内容",
  28. "create_time": "2017-04-10 16:29:29"
  29. },
  30. {
  31. "goods_consult_id": 17,
  32. "type": 5,
  33. "content": "可以有多个回复",
  34. "create_time": "2017-04-10 16:29:29"
  35. }
  36. ]
  37. },
  38. {
  39. "goods_consult_id": 11,
  40. "type": 5,
  41. "content": "咨询",
  42. "is_show": 1,
  43. "status": 1,
  44. "create_time": "2017-04-10 16:19:19",
  45. "get_user": {
  46. "username": "carey",
  47. "nickname": "careya",
  48. "head_pic": "//head_pic.jpg"
  49. },
  50. "get_goods": {
  51. "goods_id": 1,
  52. "name": "编辑一个商品",
  53. "attachment": []
  54. },
  55. "get_answer": [
  56. {
  57. "goods_consult_id": 18,
  58. "type": 5,
  59. "content": "回复",
  60. "create_time": "2017-04-10 16:19:19"
  61. }
  62. ]
  63. }
  64. ],
  65. "total_result": 2
  66. }
  67. }

备注:

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

  2. 参数goods_id值为0,表示获取所有咨询,否则表示获取指定商品的咨询列表。

  3. 参数goods_id值不填或为0的时候,将返回get_goods字段,包含商品对象数据。

  4. 参数is_answer值为1时将返回get_answer字段。

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