Documentazione
Client e API
Panoramica API
Aggiornata 2026-11-03
Panoramica API
L'API è versionata sotto /api/v1, autenticata con Sanctum e coperta da un test di parità OpenAPI.
Convenzioni
- Richieste e risposte JSON.
- Flusso guest-first; register/login aggiornano l'account guest.
- Errori di validazione
422con messaggi per campo. - Errori di dominio
422conmessage. - Proprietà imposta da policy e query scoped.
- Endpoint mutanti con throttle.
- Chiavi di idempotenza per ricompense e submission.
- Risultati autoritativi lato server; nessuna fuga di seed o risposte.
Aree
| Area | Esempi |
|---|---|
| Auth | register, login, logout, logout-all, verifica, reset password, 2FA |
| Catalogo | lista, ricerca, filtri avanzati, opzioni, profili |
| Collezione | lista, carta, preferito, admit, vendita, azioni vita, slot |
| Gare | creazione, lineup, calcolo, risultato, storico, reward card |
| Economia | wallet, pacchetti, scambio premium, rewarded center |
| Trading | listing, offerte, aste, listing seguiti |
| Social | club, messaggi, moderazione, segnalazioni, sanzioni, appelli |
| Quiz | set, submit, mastery review, error monsters |
| Control | health, versione, licenza, theme sync e manutenzione firmati HMAC (feature-gated) |
| Manual | sezioni pubblicate |
Health
GET /api/v1/health
Contratto
Il documento OpenAPI è codebase/api/OPENAPI.yaml. Il test di parità fallisce quando route e documento non coincidono.
Sicurezza
- I token scadono (
AUTH_TOKEN_TTL_DAYS). - Giocatori sospesi o bannati sono bloccati.
- Gli account in cancellazione sono bloccati.
- Le azioni sensibili sono tracciate.
- L'API control richiede firma HMAC, finestra temporale e nonce.