Autenticación

Autenticación

Endpoints para la autenticación de usuarios en el sistema.

POST /api/v1/auth/authenticate

Autentica un usuario en el sistema.

Headers requeridos

Content-Type: application/json
Accept: application/json

Parámetros del cuerpo

Parámetro	Tipo	Requerido	Descripción
email	string	Sí	Email del usuario
password	string	Sí	Contraseña del usuario
ruc	string	No	RUC de la empresa (para múltiples empresas)

Ejemplo de solicitud

{
    "email": "[email protected]",
    "password": "contraseña123",
    "ruc": "0123456789001"
}

Respuestas

200 OK

{
    "message": "Usuario autenticado",
    "status": "OK",
    "payload": {
        "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
        "user": {
            "uuid": 123456789,
            "name": "Usuario",
            "email": "[email protected]",
            "status": "active"
        },
        "company": {
            "name": "Empresa Ejemplo",
            "ruc": "0123456789001",
            "address": "Dirección de la empresa"
        }
    }
}

401 Unauthorized

{
    "message": "Credenciales inválidas",
    "status": "ERROR"
}

POST /api/v1/auth/providers-auth

Autenticación para proveedores.

Headers requeridos

Content-Type: application/json
Accept: application/json

Parámetros del cuerpo

Parámetro	Tipo	Requerido	Descripción
email	string	Sí	Email del proveedor
password	string	Sí	Contraseña del proveedor

Respuestas

200 OK

{
    "message": "Proveedor autenticado",
    "status": "OK",
    "payload": {
        "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
        "user": {
            "uuid": 123456789,
            "name": "Proveedor",
            "email": "[email protected]"
        }
    }
}

GET /api/v1/auth/logout

Cierra la sesión del usuario autenticado.

Headers requeridos

Accept: application/json
Authorization: Bearer {token}

Respuestas

200 OK

{
    "message": "Sesión cerrada exitosamente",
    "status": "OK"
}

401 Unauthorized

{
    "message": "Token inválido",
    "status": "ERROR"
}

GET /api/v1/auth/refresh-token

Renueva el token de autenticación del usuario.

Headers requeridos

Accept: application/json
Authorization: Bearer {token}

Respuestas

200 OK

{
    "message": "Token renovado",
    "status": "OK",
    "payload": {
        "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."
    }
}