ajoute l'API publique /api/v1 (bloc B, premier chantier)

Catalogue en lecture seule (labs, banque de quiz officielle, cours) -
choix d'Adam pour la première version, zéro donnée d'élève. Laravel
Sanctum, un jeton Bearer par développeur créé depuis /jetons-api (un
prof), portée catalogue:lire seulement. Quota par jeton (pas par
compte ni par IP) dans Redis via un limiteur nommé, 60 requêtes/minute.
Documentation : spécification OpenAPI 3.0 et page publique /api/docs.

Désactive /sanctum/csrf-cookie (config/sanctum.php) : l'API est en
jeton Bearer seulement, jamais en cookie de SPA.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Adam Belkacemi 2026-10-14 01:23:23 +02:00
parent 3b961209f5
commit ecf3dfb21d
22 changed files with 874 additions and 2 deletions

View file

@ -5,7 +5,10 @@ namespace App\Providers;
use App\Models\Eleve;
use App\Models\User;
use App\Services\CompteurDevoirsEnAttente;
use Illuminate\Cache\RateLimiting\Limit;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Auth;
use Illuminate\Support\Facades\RateLimiter;
use Illuminate\Support\Facades\View;
use Illuminate\Support\ServiceProvider;
@ -39,5 +42,13 @@ class AppServiceProvider extends ServiceProvider
'badgeMesDevoirs' => $compte instanceof Eleve ? CompteurDevoirsEnAttente::pour($compte) : 0,
]);
});
// API publique (bloc B) : quota par jeton Sanctum, pas par compte ni
// par IP — un même prof avec deux jetons a deux quotas séparés.
// CACHE_STORE=redis en production (voir CLAUDE.md : « Redis pour les
// quotas »), stocké dans config/cache.php -> 'database' en local/test.
RateLimiter::for('api', fn (Request $request) => Limit::perMinute(60)->by(
$request->user()?->currentAccessToken()?->id ?? $request->ip()
));
}
}