Manual · 9
Endpoints de autenticación y usuarios
| Método | Ruta | Descripción |
|---|---|---|
| POST | /auth/login |
Iniciar sesión (consulta Autenticación) |
| POST | /auth/logout |
Cerrar sesión |
| GET | /auth/me |
Obtener el propio usuario |
| GET | /auth/setup-status |
Comprueba si la configuración inicial aún está pendiente (público). Respuesta { "needs_setup", "manual_available", "demo_available" } – los dos últimos indican si se pueden instalar el manual y los datos de demostración (solo mientras needs_setup sea verdadero) |
| POST | /auth/setup |
Crear la primera cuenta de administrador (solo si aún no existe ningún usuario, público). Cuerpo { "username", "password", "manual": true, "demo": false } – manual (si falta = true) instala el manual, demo los datos de demostración, ver Configuración inicial. Respuesta 201 con el usuario más manual_installed/demo_installed. Opción no disponible: 400 manual_unavailable/demo_unavailable (no se crea nada). Fallo al instalar: 500 manual_install_failed/demo_install_failed – la cuenta y la sesión se mantienen |
| GET | /auth/tokens |
Listar los propios tokens de API |
| POST | /auth/tokens |
Crear un nuevo token de API (valor visible solo una vez) |
| DELETE | /auth/tokens/{id} |
Revocar token de API |
| POST | /auth/users/{id}/password |
Cambiar la propia contraseña |
| GET | /auth/users |
Listar todos los usuarios (Admin) |
| POST | /auth/users |
Crear usuario (Admin) |
| PATCH | /auth/users/{id} |
Editar usuario (Admin) |
| DELETE | /auth/users/{id} |
Eliminar usuario (Admin) |
| GET | /auth/users/{id}/groups |
Grupos de un usuario |
| GET | /auth/users/{id}/table-permissions |
Permisos de tabla de un usuario (Admin) |
| PUT | /auth/users/{id}/table-permissions |
Establecer permisos de tabla (Admin) |