API 接口说明文档
import requests
def get_api_data():
#自行调整页数:page,limit最大50
url = "https://api.kuakema.com/posts/?page=1&limit=50"
try:
response = requests.get(url)
if response.status_code == 200:
data = response.json()
return data
else:
print(f"请求失败,状态码: {response.status_code}")
except requests.exceptions.RequestException as e:
print(f"请求发生错误: {e}")
if __name__ == "__main__":
api_data = get_api_data()
if api_data:
# 这里可以根据实际返回的数据结构进行进一步处理
for post in api_data['posts']:
log_title = post['log_Title']
if isinstance(log_title, list) and len(log_title) == 1:
log_title = log_title[0]
# 先去除字符串两端的空格
log_title = log_title.strip()
# 删除 " 短剧《 " 和 " 》免费观看"
log_title = log_title.replace("短剧《 ", "").replace(" 》免费观看", "")
log_post_time = post['log_PostTime']
log_source_link = post['log_SourceLink']
print("log_Title:", log_title, "log_PostTime:", log_post_time, "log_SourceLink:", log_source_link)
待更新!
基本信息
基础URL https://api.kuakema.com/ & https://api.kuakema.cn
支持格式 JSON
字符编码 UTF-8
资源类型
类型 路径 说明
短剧 /duanju 短剧相关内容
动漫 /dongman 动漫相关内容
电影 /movie 电影相关内容
电视剧 /tv 电视剧相关内容
学习 /xuexi 学习资源内容
API 端点
- 获取文章列表
获取指定类型的文章列表,支持分页和搜索。
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
默认按更新时间倒序排序
关键词搜索支持模糊匹配