接口描述:

  • 获取消息列表(后台)。

请求 URL:

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

请求方式:

  • GET
  • POST

是否授权:

  • 需要授权

业务参数:

参数名 类型 是否必须 范围值 默认值 示例值 描述
type integer between:0,9 0 消息类型(自定义)
member integer in:1,2 1 消息成员组 1=顾客组 2=管理组
title string max:200 活动公告 消息标题
is_top integer in:0,1 0 是否置顶 0=否 1=是
status integer in:0,1 1 消息状态 0=禁用 1=启用
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 message_id status 排序字段

附属 A:
in:message_id,type,page_views,is_top,status,create_time,update_time

响应参数:

参数名 类型 是否返回 示例值 描述
status integer 200 状态码
message string success 消息信息
data object [] 返回对象
data 类型 是否返回 示例值 描述
items array [] 列表项
total_result integer 2 合计计数
items 类型 是否返回 示例值 描述
message_id integer 8 消息编号
type integer 0 消息类型(自定义)
member integer 1 消息成员组 1=顾客组 2=管理组
title string 活动公告 消息标题
content string 活动内容 消息内容
url string http://careyshop.cn 外部链接
target string _blank 打开方式
page_views integer 0 游览量
is_top integer 0 是否置顶 0=否 1=是
status integer 1 消息状态 0=禁用 1=启用
create_time datetime 2018-06-06 22:49:59 创建时间
update_time datetime 2018-06-06 22:49:59 更新时间

响应示例:

  1. {
  2. "status": 200,
  3. "message": "success",
  4. "data": {
  5. "items": [
  6. {
  7. "message_id": 8,
  8. "type": 0,
  9. "member": 1,
  10. "title": "活动公告",
  11. "content": "活动内容",
  12. "url": "http://careyshop.cn",
  13. "target": "_blank",
  14. "page_views": 0,
  15. "is_top": 0,
  16. "status": 1,
  17. "create_time": "2018-06-06 22:49:59",
  18. "update_time": "2018-06-06 23:16:52"
  19. },
  20. {
  21. "message_id": 5,
  22. "type": 0,
  23. "member": 2,
  24. "title": "title-5",
  25. "content": "content",
  26. "url": "",
  27. "target": "_self",
  28. "page_views": 15,
  29. "is_top": 0,
  30. "status": 1,
  31. "create_time": "2017-11-27 14:16:52",
  32. "update_time": "2017-11-27 14:16:52"
  33. }
  34. ],
  35. "total_result": 2
  36. }
  37. }

备注:

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