查询本地配置的数据源中的云盘资源。支持按资源 ID 获取详情,也支持按标题、发布时间分页检索列表,适合作为资源库搜索和详情页的数据接口。
https://api.116818.xyz/api/cloud_search
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
id |
integer | 否 | 资源 ID。传入后返回单条资源详情;不传则返回资源列表 |
title |
string | 否 | 资源标题关键词,列表模式下支持模糊搜索 |
publish_time |
string | 否 | 发布时间筛选,需与数据源中的发布时间格式一致 |
page |
integer | 否 | 页码,默认 1 |
limit |
integer | 否 | 每页数量,默认 20,最大 100 |
sort |
string | 否 | 排序字段,支持 id、title、publish_time、created_at、updated_at |
order |
string | 否 | 排序方式,支持 ASC 或 DESC,默认 DESC |
/api/cloud_search?title=%E7%94%B5%E5%BD%B1&page=1&limit=20&sort=publish_time&order=DESC
/api/cloud_search?id=1001
{
"code": 200,
"msg": "success",
"data": {
"total": 128,
"page": 1,
"limit": 20,
"list": [
{
"id": 1001,
"title": "资源标题",
"publish_time": "2026-05-13",
"created_at": "2026-05-13 12:00:00",
"updated_at": "2026-05-13 12:00:00"
}
]
},
"timestamp": 1778640000
}
| 字段名 | 类型 | 说明 |
|---|---|---|
code |
integer | 业务状态码,200 表示成功 |
msg |
string | 响应提示信息 |
data.total |
integer | 列表模式下的匹配资源总数 |
data.page |
integer | 当前页码 |
data.limit |
integer | 每页数量 |
data.list |
array | 资源列表。详情模式下 data 会直接返回单条资源记录 |
data.list[].id |
integer | 资源 ID |
data.list[].title |
string | 资源标题 |
data.list[].publish_time |
string | 资源发布时间 |
timestamp |
integer | 响应生成时间戳 |
https://api.116818.xyz/api/cloud_search?id=%3Cid%3E&title=%3Ctitle%3E&publish_time=%3Cpublish_time%3E&page=%3Cpage%3E&limit=%3Climit%3E&sort=%3Csort%3E&order=%3Corder%3E
X-Cache-Status 判断 HIT / MISS。