公开API接口文档，支持资源添加、搜索和热门剧获取等功能
认证方式：所有API都需要提供API Token进行认证
请求头方式：X-API-Token: your_token
查询参数方式：?api_token=your_token
获取Token：请联系管理员在系统配置中设置API Token
添加单个资源到待处理列表
方法：POST
路径：/api/public/resources/add
认证：必需
{
"title": "资源标题",
"description": "资源描述",
"url": "资源链接",
"category": "分类名称",
"tags": "标签1,标签2",
"img": "封面图片链接",
"source": "数据来源",
"extra": "额外信息"
}{
"success": true,
"message": "资源添加成功，已进入待处理列表",
"data": {
"id": 123
},
"code": 200
}批量添加多个资源到待处理列表
方法：POST
路径：/api/public/resources/batch-add
认证：必需
{
"resources": [
{
"title": "资源1",
"url": "链接1",
"description": "描述1"
},
{
"title": "资源2",
"url": "链接2",
"description": "描述2"
}
]
}{
"success": true,
"message": "批量添加成功，共添加 2 个资源",
"data": {
"created_count": 2,
"created_ids": [123, 124]
},
"code": 200
}搜索资源，支持关键词、标签、分类过滤
方法：GET
路径：/api/public/resources/search
认证：必需
keyword - 搜索关键词
tag - 标签过滤
category - 分类过滤
page - 页码（默认1）
page_size - 每页数量（默认20，最大100）
{
"success": true,
"message": "搜索成功",
"data": {
"resources": [
{
"id": 1,
"title": "资源标题",
"url": "资源链接",
"description": "资源描述",
"view_count": 100,
"created_at": "2024-12-19 10:00:00",
"updated_at": "2024-12-19 10:00:00"
}
],
"total": 50,
"page": 1,
"page_size": 20
},
"code": 200
}获取热门剧列表，支持分页
方法：GET
路径：/api/public/hot-dramas
认证：必需
page - 页码（默认1）
page_size - 每页数量（默认20，最大100）
{
"success": true,
"message": "获取热门剧成功",
"data": {
"hot_dramas": [
{
"id": 1,
"title": "剧名",
"description": "剧集描述",
"img": "封面图片",
"url": "详情链接",
"rating": 8.5,
"year": "2024",
"region": "中国大陆",
"genres": "剧情,悬疑",
"category": "电视剧",
"created_at": "2024-12-19 10:00:00",
"updated_at": "2024-12-19 10:00:00"
}
],
"total": 20,
"page": 1,
"page_size": 20
},
"code": 200
}200 - 请求成功
400 - 请求参数错误
401 - 认证失败（Token无效或缺失）
500 - 服务器内部错误
503 - 系统维护中或API Token未配置
{
"success": true/false,
"message": "响应消息",
"data": {}, // 响应数据
"code": 200 // 状态码
}# 设置API Token
API_TOKEN="your_api_token_here"
# 单个添加资源
curl -X POST "http://localhost:8080/api/public/resources/add" \
-H "Content-Type: application/json" \
-H "X-API-Token: $API_TOKEN" \
-d '{
"title": "测试资源",
"url": "https://example.com/resource",
"description": "测试描述"
}'
# 搜索资源
curl -X GET "http://localhost:8080/api/public/resources/search?keyword=测试" \
-H "X-API-Token: $API_TOKEN"
# 获取热门剧
curl -X GET "http://localhost:8080/api/public/hot-dramas?page=1&page_size=5" \
-H "X-API-Token: $API_TOKEN"