接口描述:

  • 获取专题列表。

请求 URL:

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

请求方式:

  • GET
  • POST

是否授权:

业务参数:

参数名 类型 是否必须 范围值 默认值 示例值 描述
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 topic_id status 排序字段

附属 A:
in:topic_id,title,alias,status,create_time,update_time

响应参数:

参数名 类型 是否返回 示例值 描述
status integer 200 状态码
message string success 消息信息
data object [] 返回对象
data 类型 是否返回 示例值 描述
items array [] 列表项
total_result integer 20 合计计数
items 类型 是否返回 示例值 描述
topic_id integer 27 专题编号
title string 标题 专题标题
alias string 短标题 专题别名
keywords string 关键词 专题关键词
description string 描述 专题描述
status integer 1 专题是否显示 0=否 1=是
create_time datetime 2018-05-04 09:25:34 创建时间
update_time datetime 2018-05-04 09:31:52 更新时间

响应示例:

  1. {
  2. "status": 200,
  3. "message": "success",
  4. "data": {
  5. "items": [
  6. {
  7. "topic_id": 27,
  8. "title": "标题",
  9. "alias": "短标题",
  10. "keywords": "关键词",
  11. "description": "描述",
  12. "status": 1,
  13. "create_time": "2018-05-04 09:25:34",
  14. "update_time": "2018-05-04 09:31:52"
  15. },
  16. {
  17. "topic_id": 26,
  18. "title": "标题",
  19. "alias": "",
  20. "keywords": "",
  21. "description": "",
  22. "status": 1,
  23. "create_time": "2018-05-04 09:23:47",
  24. "update_time": "2018-05-04 09:23:47"
  25. }
  26. ],
  27. "total_result": 20
  28. }
  29. }

备注:

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