You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 

67 lines
2.4 KiB

<?php
declare(strict_types=1);
/**
* api.php
* Created by PhpStorm.
* Date: 2026/10/17
* Time: 09:40
* Author: qian.guo
* E-mail: yiyezhiqiutel@gmail.com
*/
use app\middleware\LoginCheck;
use app\middleware\RateLimitCheck;
use think\facade\Route;
/*
| 全部 API 路由,统一前缀 /api/v1
|
| 鉴权策略:需要登录的路由挂 LoginCheck,不需要的不挂
| 不用「全局挂载 + 控制器内判断」—— 那种写法迟早会漏判一处
*/
Route::group('api/v1', function () {
Route::get('health', 'Common/health');
/* ---------------- 登录 ---------------- */
Route::group('auth', function () {
// 登录接口必须限流:它是唯一免鉴权且会写数据的入口
// 不限流等于给脚本开一个无限注册机
Route::post('login', 'Auth/login')
->middleware(RateLimitCheck::class, 'auth_login', 20, 60);
// 校验 token 是否仍有效(前端冷启动用),必须挂在鉴权下
Route::get('check', 'Auth/checkToken')
->middleware(LoginCheck::class);
});
/* ---------------- 用户资料(全部需登录) ---------------- */
Route::group('user', function () {
Route::get('profile', 'User/getProfileInfo');
Route::post('profile', 'User/profileUpdate');
Route::post('deactivate', 'User/accountDeactivate');
})->middleware(LoginCheck::class);
/* ---------------- 测评 ---------------- */
Route::group('quiz', function () {
// 取试卷免登录:用户在「开始测评」时才登录,登录前就要能渲染首页
Route::get('paper', 'Quiz/getPaperInfo');
/*
* 交卷评分:免登录,但必须限流。
* 不限流的话,这里是唯一「免鉴权 + 会消耗 CPU」的入口,
* 一个循环就能把服务器打满。
* 阈值 10 次/分钟/IP:正常人 3 分钟内只会交一次卷,
* 留余量是为了容忍弱网重试与多人共用同一个出口 IP(如公司/学校)。
*/
Route::post('submit', 'Quiz/submitAnswers')
->middleware(RateLimitCheck::class, 'quiz_submit', 10, 60);
});
/* ---------------- 运维/调试 ---------------- */
Route::group('system', function () {
Route::get('strategies', 'Common/getStrategyList')
->middleware(RateLimitCheck::class, 'system', 30, 60);
});
});