内容操作
获取内容列表
接口
GET /hserve/v2.2/content/detail/
info 该接口支持通过参数 return_total_count 指定是否返回查询对象总数,以协助不关心对象总数只关心查询结果列表的开发者提升接口响应速度。 同时,从 v2.2 版本开始该接口默认不返回查询对象总数,欲获取总数的开发者需要显式指定 return_total_count 参数。
请求参数
where
查询语句order_by
排序字段return_total_count
指定是否在返回结果 meta 中返回 total_count
以下参数需二选一 可选:
category_id
分类 IDcontent_group_id
内容库 ID
where
可参考查询数据中的使用方式
开发者只需要获取对象总数,则可以通过设置 limit=1
以及 return_total_count=1
来达到该效果,total_count 可从返回的 meta 中获取
请求示例:
请求示例
返回参数说明
参数 | 类型 | 说明 |
---|---|---|
id | integer | 内容 ID |
title | string | 内容标题 |
cover | file | 封面图 |
description | string | 内容摘要 |
categories | array | 所需分类的 ID |
group_id | integer | 内容库 ID |
created_at | integer | 内容创建时间 |
updated_at | integer | 内容更新时间 |
created_by | integer | 创建者 id |
offset | integer | 偏移量 |
limit | integer | 每次请求返回的最大记录数目 |
previous | string | 上一页地址 |
next | string | 下一页地址 |
total_count | integer | 记录总数目,仅当 return_total_count 为 1 时返回 |
返回示例
获取内容详情
接口
GET /hserve/v2.2/content/detail/:content_id/
其中 content_id
是内容的 ID
请求示例
返回示例
返回参数说明
内容表内置字段:
参数 | 类型 | 说明 |
---|---|---|
id | integer | 内容 ID |
title | string | 内容标题 |
content | string | 详细容 |
cover | file | 封面图 |
description | string | 内容摘要 |
group_id | integer | 内容库 ID |
categories | integer array | 内容所属分类的ID |
created_at | integer | 内容创建时间 |
updated_at | integer | 内容更新时间 |
状态码说明
200
: 获取成功
Last updated