请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
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 | 响应生成时间戳 |
字段说明根据返回示例自动推断；复杂字段以真实接口返回为准。
请求示例 URL
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