Manuale · 9

Endpoint di autenticazione e utenti

Metodo Percorso Descrizione
POST /auth/login Accesso (vedi Autenticazione)
POST /auth/logout Disconnessione
GET /auth/me Recupera il proprio utente
GET /auth/setup-status Verifica se la configurazione iniziale è ancora in sospeso (pubblico). Risposta { "needs_setup", "manual_available", "demo_available" } – gli ultimi due indicano se manuale e dati demo possono essere installati (solo finché needs_setup è vero)
POST /auth/setup Crea il primo account admin (solo se non esiste ancora nessun utente, pubblico). Corpo { "username", "password", "manual": true, "demo": false } – manual (assente = true) installa il manuale, demo i dati demo, vedi Configurazione iniziale. Risposta 201 con l’utente più manual_installed/demo_installed. Opzione non disponibile: 400 manual_unavailable/demo_unavailable (non viene creato nulla). Installazione non riuscita: 500 manual_install_failed/demo_install_failed – account e sessione restano
GET /auth/tokens Elenca i propri token API
POST /auth/tokens Crea un nuovo token API (valore visibile una sola volta)
DELETE /auth/tokens/{id} Revoca un token API
POST /auth/users/{id}/password Cambia la propria password
GET /auth/users Elenca tutti gli utenti (Admin)
POST /auth/users Crea un utente (Admin)
PATCH /auth/users/{id} Modifica un utente (Admin)
DELETE /auth/users/{id} Elimina un utente (Admin)
GET /auth/users/{id}/groups Gruppi di un utente
GET /auth/users/{id}/table-permissions Permessi sulle tabelle di un utente (Admin)
PUT /auth/users/{id}/table-permissions Imposta i permessi sulle tabelle (Admin)