<?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);
|
|
});
|
|
});
|