内容库操作
获取内容库详情
接口
GET /hserve/v2.2/content/group/:content_group_id/
其中 content_group_id
是内容库的 ID
请求示例
curl -X GET \
-H "Authorization: Hydrogen-r1 {{AccessToken}}" \
-H "X-Hydrogen-Client-ID: [[client_id]]" \
-H "Content-Type: application/json" \
https://{{服务器域名}}/hserve/v2.2/content/group/1/
返回示例
{
"id": 1,
"name": "内容库"
}
获取内容库列表
接口
GET /hserve/v2.2/content/group/
该接口支持通过参数 return_total_count 指定是否返回查询对象总数,以协助不关心对象总数只关心查询结果列表的开发者提升接口响应速度。同时,从 v2.2 版本开始该接口默认不返回查询对象总数,欲获取总数的开发者需要显式指定 return_total_count 参数。
若开发者只需要获取对象总数,则可以通过设置 limit=1
以及 return_total_count=1
来达到该效果,total_count 可从返回的 meta 中获取
请求示例:
https://{{服务器域名}}/hserve/v2.2/content/group/?limit=1&return_total_count=1
请求示例
curl -X GET \
-H "Authorization: Hydrogen-r1 {{AccessToken}}" \
-H "X-Hydrogen-Client-ID: [[client_id]]" \
-H "Content-Type: application/json" \
https://{{服务器域名}}/hserve/v2.2/content/group/
返回参数说明
参数 | 类型 | 说明 |
---|---|---|
id | string | id, 唯一标识 |
name | string | 名称 |
offset | integer | 偏移量 |
limit | integer | 每次请求返回的最大记录数目 |
previous | string | 上一页地址 |
next | string | 下一页地址 |
total_count | integer | 记录总数目,仅当 return_total_count 为 1 时返回该字段 |
返回示例
{
"meta": {
"limit": 20,
"next": null,
"offset": 0,
"previous": null,
"total_count": 1
},
"objects": [
{
"id": 1,
"name": "内容库",
}
]
}