Autenticación
La API usa tokens de Laravel Sanctum. Primero inicias sesión para obtener un token y luego lo envías en cada solicitud.
Iniciar sesión
Sección titulada «Iniciar sesión»POST /api/login (también disponible como POST /api/auth/login).
Esta ruta tiene límite de intentos (throttle:login) y bloquea al usuario tras intentos fallidos.
Parámetros del cuerpo
Sección titulada «Parámetros del cuerpo»| Parámetro | Tipo | Descripción |
|---|---|---|
email |
string | Correo del usuario. Obligatorio si no envías username. |
username |
string | Nombre de usuario. Obligatorio si no envías email. |
password |
string | Obligatorio. Contraseña. |
recaptchaToken |
string | Token de reCAPTCHA. Es obligatorio salvo que el servidor lo tenga desactivado. |
Respuesta
Sección titulada «Respuesta»{ "access_token": "1|abc123...", "token_type": "Bearer"}El token lleva como habilidades los permisos del usuario (por ejemplo cashbox.movement.create). Por eso cada endpoint valida el permiso con tokenCan, y un token solo puede hacer lo que su usuario puede hacer.
Usar el token
Sección titulada «Usar el token»Envía el token en la cabecera Authorization:
curl "https://servererp.allendostmen.app/api/auth/user" \ -H "Authorization: Bearer $TOKEN" \ -H "Accept: application/json"Rutas de la sesión
Sección titulada «Rutas de la sesión»| Método | Ruta | Acción |
|---|---|---|
| GET | /api/auth/user |
Devuelve el usuario autenticado con su rol y permisos. |
| GET | /api/auth/token |
Lista los tokens del usuario. |
| DELETE | /api/auth/token |
Cierra la sesión: elimina el token actual. |
| DELETE | /api/auth/token/{id} |
Elimina un token concreto. |
