🔐 Autenticacion
Flujo completo de autenticación para la API de Facturación Electrónica SRI.
🔑 Inicio de Sesión
Endpoint: POST /api/login
Autentica al usuario y devuelve un token de API para solicitudes posteriores.
Parámetros de Solicitud
| Parámetro | Tipo | Requerido | Descripción | Validación | |
| ----------- | ------ | ---------- | ------------- | ------------ | |
email | string | ✅ | Correo electrónico del usuario | `required | email` |
password | string | ✅ | Contraseña del usuario | `required | string` |
Ejemplo de Solicitud
#### Iniciar sesión
curl -X POST "{{ url('/api/login') }}" \
-H "Content-Type: application/json" \
-d '{
"email": "[email protected]",
"password": "SecurePass123!"
}'
Ejemplos de Respuesta
#### Éxito (200 OK)
{
"status": "ok",
"code": 200,
"message": "Inicio de sesión exitoso",
"data": {
"user": {
"id": 1,
"name": "Juan Pérez",
"email": "[email protected]"
},
"token": "1|abc123def456789012345678901234567890xyz",
"token_type": "Bearer",
"expires_in": 1440
}
}
#### Credenciales inválidas (401)
{
"status": "error",
"code": 401,
"message": "Credenciales inválidas",
"error_code": "AUTH_001"
}
#### Cuenta inactiva (403)
{
"status": "error",
"code": 403,
"message": "La cuenta está inactiva. Por favor contacta al administrador.",
"error_code": "AUTH_002"
}
🚪 Cerrar Sesión
Endpoint: POST /api/logout
Invalida el token de API actual.
Encabezados de Solicitud
| Encabezado | Valor | Descripción |
| ------------ | ------- | ------------- |
Authorization | Bearer {token} | Token de API válido |
Content-Type | application/json | Tipo de contenido |
Ejemplo de Solicitud
#### Cerrar sesión
curl -X POST "{{ url('/api/logout') }}" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json"
Ejemplos de Respuesta
#### Éxito (200 OK)
{
"status": "ok",
"code": 200,
"message": "Sesión cerrada correctamente",
"data": []
}
#### Token inválido (401)
{
"status": "error",
"code": 401,
"message": "Token inválido o expirado",
"error_code": "AUTH_003"
}