高手榜
- 基础 URL:
https://api.639986.top/ - 前缀:
/api/expert_rank - 认证:
- 查询列表无需登录
- 增、删、改需携带 JWT 令牌（
Authorization: Basic <token>） - 响应格式: JSON
1. 查询高手榜列表
- 方法:
GET - URL:
/api/expert_rank/list - 参数:
issue(string, 必填): 彩票期数，例如2025001- 响应:
- 成功 (200):
json { "data": [ { "id": 1, "issue": "2025001", "title": "高手预测", "content": "<p>本期预测内容...</p>" } ] } - 失败 (404):
json {"detail": "期数 2025001 不存在"} - 示例:
bash curl "http://localhost:5001/api/expert_rank/list?issue=2025001"
2. 添加高手榜记录
- 方法:
POST - URL:
/api/expert_rank/add -
请求头:
-
Authorization: Basic <token> Content-Type: application/json- 请求体:
json
{
"issue": "2025001",
"title": "高手预测",
"content": "<p>本期预测内容...</p>"
}
* 响应:
-
成功 (200):
json {"message": "高手榜记录添加成功"}* 失败 (404):json {"detail": "期数 2025001 不存在"}* 失败 (401):json {"detail": "未授权，请登录"}* 示例:
bash
curl -X POST "http://localhost:5001/api/expert_rank/add" \
-H "Authorization: Basic <token>" \
-H "Content-Type: application/json" \
-d '{"issue": "2025001", "title": "高手预测", "content": "<p>本期预测内容...</p>"}'
3. 更新高手榜记录
- 方法:
PUT - URL:
/api/expert_rank/{id} -
参数:
-
id(integer, 必填): 记录 ID -
请求头:
-
Authorization: Basic <token> Content-Type: application/json- 请求体:
json
{
"title": "更新标题",
"content": "<p>更新内容...</p>"
}
* 响应:
-
成功 (200):
json {"message": "高手榜记录更新成功"}* 失败 (400):json {"detail": "请提供至少一个要更新的字段"}* 失败 (404):json {"detail": "记录 id 1 不存在"}* 失败 (401):json {"detail": "未授权，请登录"}* 示例:
bash
curl -X PUT "http://localhost:5001/api/expert_rank/1" \
-H "Authorization: Basic <token>" \
-H "Content-Type: application/json" \
-d '{"title": "更新标题", "content": "<p>更新内容...</p>"}'
4. 删除高手榜记录
- 方法:
DELETE - URL:
/api/expert_rank/{id} -
参数:
-
id(integer, 必填): 记录 ID -
请求头:
-
Authorization: Basic <token> -
响应:
-
成功 (200):
json {"message": "高手榜记录删除成功"}* 失败 (404):json {"detail": "记录 id 1 不存在"}* 失败 (401):json {"detail": "未授权，请登录"}* 示例:
bash
curl -X DELETE "http://localhost:5001/api/expert_rank/1" \
-H "Authorization: Basic <token>"