Manuel · 9

Points d'accès authentification & utilisateurs

Méthode Chemin Description
POST /auth/login Se connecter (voir Authentification)
POST /auth/logout Se déconnecter
GET /auth/me Récupérer son propre utilisateur
GET /auth/setup-status Vérifie si la configuration initiale est encore en attente (public). Réponse { "needs_setup", "manual_available", "demo_available" } – les deux derniers indiquent si le manuel et les données de démonstration peuvent être installés (uniquement tant que needs_setup est vrai)
POST /auth/setup Créer le premier compte admin (uniquement si aucun utilisateur n’existe encore, public). Corps { "username", "password", "manual": true, "demo": false } – manual (absent = true) installe le manuel, demo les données de démonstration, voir Configuration initiale. Réponse 201 avec l’utilisateur plus manual_installed/demo_installed. Option indisponible : 400 manual_unavailable/demo_unavailable (rien n’est créé). Échec de l’installation : 500 manual_install_failed/demo_install_failed – le compte et la session restent
GET /auth/tokens Lister ses propres jetons API
POST /auth/tokens Créer un nouveau jeton API (valeur visible une seule fois)
DELETE /auth/tokens/{id} Révoquer un jeton API
POST /auth/users/{id}/password Changer son propre mot de passe
GET /auth/users Lister tous les utilisateurs (admin)
POST /auth/users Créer un utilisateur (admin)
PATCH /auth/users/{id} Modifier un utilisateur (admin)
DELETE /auth/users/{id} Supprimer un utilisateur (admin)
GET /auth/users/{id}/groups Groupes d’un utilisateur
GET /auth/users/{id}/table-permissions Autorisations de table d’un utilisateur (admin)
PUT /auth/users/{id}/table-permissions Définir les autorisations de table (admin)