| 基础URL | https://api.kuakema.com https://api.kuakema.cn |
|---|---|
| 支持格式 | JSON |
| 字符编码 | UTF-8 |
资源类型
| 类型 | 路径 | 说明 |
|---|---|---|
| 短剧 | /duanju | 短剧相关内容 |
| 动漫 | /dongman | 动漫相关内容 |
| 电影 | /movie | 电影相关内容 |
| 电视剧 | /tv | 电视剧相关内容 |
| 学习 | /xuexi | 学习资源内容 |
API 端点
1. 获取文章列表
获取指定类型的文章列表，支持分页和搜索。
GET
/{resource_type}请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| keyword | string | 否 | 搜索关键词 | 海贼王 |
| page | integer | 否 | 页码 | 1 |
| page_size | integer | 否 | 每页数量(1-100) | 20 |
响应示例
{
"count": 100,
"current_page": 1,
"size": 20,
"pages": 5,
"list": [
{
"id": 1,
"title": "标题",
"source_link": "https://example.com",
"update_time": "2024-01-04T12:00:00"
}
]
}2. 获取文章详情
获取指定文章的详细信息。
GET
/{resource_type}/{id}路径参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| resource_type | string | 资源类型(duanju/dongman/movie/tv) |
| id | integer | 文章ID |
响应示例
{
"id": 1,
"title": "标题",
"source_link": "https://example.com",
"update_time": "2024-01-04T12:00:00"
}3. 获取所有类型数据
获取所有类型的数据，支持分页和搜索。
GET
/all请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| keyword | string | 否 | 搜索关键词 | 海贼王 |
| page | integer | 是 | 页码 | 1 |
| page_size | integer | 否 | 每页数量(1-100) | 20 |
响应示例
{
"count": 400,
"current_page": 1,
"size": 20,
"pages": 20,
"list": [
{
"id": 1,
"title": "标题",
"source_link": "https://example.com",
"update_time": "2024-01-04T12:00:00",
"type": "movie"
}
]
}4. 搜索功能
所有资源类型都支持标题搜索功能。
搜索方式
| 搜索类型 | URL格式 | 说明 |
|---|---|---|
| 单类型搜索 | /{resource_type}?keyword=关键词 | 搜索指定类型的内容 |
| 全局搜索 | /all?keyword=关键词 | 搜索所有类型的内容 |
搜索参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| keyword | string | 是 | 搜索关键词 | 海贼王 |
| page | integer | 否 | 页码 | 1 |
| page_size | integer | 否 | 每页数量 | 20 |
使用示例
# 搜索短剧 curl "https://api.kuakema.com/duanju?keyword=测试" # 搜索动漫并分页 curl "https://api.kuakema.com/dongman?keyword=海贼王&page=1&page_size=20" # 搜索电影 curl "https://api.kuakema.com/movie?keyword=复仇者" # 搜索电视剧 curl "https://api.kuakema.com/tv?keyword=破案" # 搜索学习资源 curl "https://api.kuakema.com/xuexi?keyword=Python" # 搜索所有类型 curl "https://api.kuakema.com/all?keyword=热门"
响应示例
{
"count": 25,
"current_page": 1,
"size": 20,
"pages": 2,
"list": [
{
"id": 1,
"title": "海贼王 1089话",
"source_link": "https://example.com/one-piece-1089",
"update_time": "2024-01-04T12:00:00",
"type": "dongman" // 仅在 /all 接口中返回
}
]
}搜索说明
搜索支持模糊匹配（使用 LIKE 查询）
搜索范围仅限文章标题
搜索结果默认按更新时间倒序排序
搜索不区分大小写
支持中英文混合搜索
注意事项
关键词长度建议不少于2个字符
特殊字符会被自动处理
搜索结果同样受到速率限制（每分钟60次请求）
空格会被当作关键词的一部分
5. 资源类型说明
| 类型 | 路径 | 说明 | 示例关键词 |
|---|---|---|---|
| 短剧 | /duanju | 短剧相关内容 | 都市、爱情、搞笑 |
| 动漫 | /dongman | 动漫相关内容 | 海贼王、火影、龙珠 |
| 电影 | /movie | 电影相关内容 | 科幻、动作、喜剧 |
| 电视剧 | /tv | 电视剧内容 | 悬疑、古装、现代 |
| 学习 | /xuexi | 学习资源内容 | Python、Java、前端 |
6. 错误处理
| 状态码 | 说明 | 示例 |
|---|---|---|
| 400 | 请求参数错误 | 无效的表名、参数格式错误 |
| 404 | 资源不存在 | 文章ID不存在 |
| 429 | 请求过于频繁 | 超过速率限制 |
| 500 | 服务器内部错误 | 数据库查询失败 |
错误响应格式
{
"detail": "错误信息描述",
"timestamp": "2024-01-04T12:00:00"
}注意事项
访问限制
每分钟最多允许 60 次请求
支持 CORS 跨域访问
支持 GZIP 压缩
分页说明
page_size 范围：1-100
不传 page 参数时返回全部数据
传入 page 参数时返回分页格式数据
其他说明
所有时间格式为 ISO 8601
默认按更新时间倒序排序
关键词搜索支持模糊匹配