Backend / API REST documentada

API REST Spring Boot

API REST de referencia con autenticación JWT, roles, validaciones, DTOs, tests de integración y despliegue preparado.

  • Java 21
  • Spring Boot
  • Spring Security
  • JWT
  • PostgreSQL
  • JUnit
@RestController
@RequestMapping("/api/v1")
class InternalApiController {
    @GetMapping("/me")
    UserResponse currentUser(@AuthenticationPrincipal User user) {
        return users.toResponse(user);
    }
}
Ficha técnica

Arquitectura, decisiones, tests y despliegue

Problema

Convertir lógica de negocio en endpoints seguros, mantenibles y fáciles de consumir.

Arquitectura

Controladores finos, servicios de dominio, repositorios JPA, DTOs y manejador global de errores.

Decisiones

JWT con roles, validación explícita, respuestas de error consistentes y entidades no expuestas directamente.

Tests

JUnit, tests de integración y escenarios de autenticación, autorización y validación.

Despliegue

Configuración por entorno, migraciones preparadas y ejecución con base PostgreSQL real.

01

Problema

Exponer datos y operaciones internas sin mezclar controladores, seguridad, validaciones y persistencia en el mismo sitio.

02

Solución

API por capas con DTOs, Spring Security, JWT, roles, validación de entrada, errores normalizados y tests de integración.

03

Resultado

Base clara para paneles internos, integraciones y automatizaciones con documentación técnica y despliegue reproducible.