云资源查询

查询本地配置的数据源中的云盘资源。支持按资源 ID 获取详情,也支持按标题、发布时间分页检索列表,适合作为资源库搜索和详情页的数据接口。

GET / POST 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 响应生成时间戳
字段说明根据返回示例自动生成;复杂接口以实际响应为准。
请求示例 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
接口信息
  • 调用价格 免费接口
  • 鉴权方式 公开接口
  • 返回格式 JSON / 原始内容
  • 缓存状态 未启用
  • 响应头可读取 X-Cache-Status 判断 HIT / MISS。
在线测试
当前模式:GET 调试,适合快速查看查询字符串效果。