接口描述:

  • 获取问答主题列表。

请求 URL:

  • http|https://host/api/v1/ask/method/get.ask.list/

请求方式:

  • GET
  • POST

是否授权:

  • 需要授权

业务参数:

参数名 类型 是否必须 范围值 默认值 示例值 描述
ask_type integer in:0,1,2,3 0 提问类型 0=咨询 1=售后 2=投诉 3=求购
status integer in:0,1 0 是否回答 0=待回答 1=已回答
account string max:80 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 ask_id status 排序字段

附属 A:
in:ask_id,ask_type,title,status,ask_time,answer_time,username,nickname

响应参数:

参数名 类型 是否返回 示例值 描述
status integer 200 状态码
message string success 消息信息
data object [] 返回对象
data 类型 是否返回 示例值 描述
items array [] 列表项
total_result integer 20 合计计数
items 类型 是否返回 示例值 描述
ask_id integer 1 问答编号
user_id integer 1 账号编号
ask_type integer 0 提问类型 0=咨询 1=售后 2=投诉 3=求购
type integer 0 问答类型 0=主题 1=提问 2=回复
title string 主题1 主题
status integer 1 是否回答 0=待回答 1=已回答
ask_time datetiem 2018-05-05 13:18:27 提问时间
answer_time datetiem 2018-05-05 13:58:14 回答时间
get_user object [] 账号对象
get_user 类型 是否返回 示例值 描述
username string carey 账号
nickname string carey 昵称
head_pic string //host/head_pic.jpg 头像

响应示例:

  1. {
  2. "status": 200,
  3. "message": "success",
  4. "data": {
  5. "items": [
  6. {
  7. "ask_id": 7,
  8. "user_id": 1,
  9. "ask_type": 1,
  10. "type": 0,
  11. "title": "主题2",
  12. "status": 0,
  13. "ask_time": "2018-05-05 13:59:56",
  14. "answer_time": "2018-05-05 13:59:56",
  15. "get_user": {
  16. "username": "carey",
  17. "nickname": "carey",
  18. "head_pic": "//host/head_pic.jpg"
  19. }
  20. },
  21. {
  22. "ask_id": 1,
  23. "user_id": 1,
  24. "ask_type": 0,
  25. "type": 0,
  26. "title": "主题1",
  27. "status": 1,
  28. "ask_time": "2018-05-05 13:18:27",
  29. "answer_time": "2018-05-05 13:58:14",
  30. "get_user": {
  31. "username": "carey",
  32. "nickname": "carey",
  33. "head_pic": "//host/head_pic.jpg"
  34. }
  35. }
  36. ],
  37. "total_result": 2
  38. }
  39. }

备注:

  1. 该接口支持条件搜索,如果不带入业务参数则使用默认值。
文档更新时间: 2018-05-21 17:30