Ir al contenido

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.

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á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.
{
"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.

Envía el token en la cabecera Authorization:

Ventana de terminal
curl "https://servererp.allendostmen.app/api/auth/user" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json"
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.