API REST básica
Arquitectura clásica para una aplicación web con autenticación, base de datos y observabilidad.
La API REST básica es el punto de partida para la mayoría de aplicaciones web. Este modelo cubre el flujo completo desde el usuario hasta la base de datos, incluyendo autenticación, manejo de errores y logging. Es la arquitectura ideal para entender separación de responsabilidades y los fundamentos de resiliencia.
Componentes
Usuario
Persona que interactúa con la aplicación desde el navegador.
Frontend
Aplicación web que consume la API y presenta la UI al usuario.
API Backend
Servidor que expone endpoints REST y orquesta la lógica de negocio.
Auth Service
Módulo que gestiona autenticación y emisión de tokens JWT.
PostgreSQL
Base de datos relacional que persiste todos los datos de la aplicación.
Logging
Sistema que captura y centraliza los logs del backend para observabilidad.
Escenarios
Haz click en un nodo para explorarlo — los nodos con → tienen arquitectura interna
API REST básica
La API REST básica es el punto de partida para la mayoría de aplicaciones web. Este modelo cubre el flujo completo desde el usuario hasta la base de datos, incluyendo autenticación, manejo de errores y logging. Es la arquitectura ideal para entender separación de responsabilidades y los fundamentos de resiliencia.
Componentes
- — Usuario
- — Frontend
- — API Backend
- — Auth Service
- — PostgreSQL
- — Logging
Haz click en cualquier componente del diagrama para ver su rol, riesgos y alternativas.
Selecciona un escenario en la barra lateral para iniciar la simulación.
Conceptos relacionados
Recursos
Componentes de API REST básica
- Usuario: Actor externo que inicia todas las interacciones del sistema. — Enviar peticiones HTTP y consumir respuestas de la API.
- Frontend: Single Page Application o servidor web que sirve la interfaz. — Traducir acciones del usuario en llamadas HTTP a la API.
- API Backend: Aplicación backend que implementa la lógica de negocio y expone una API REST. — Procesar peticiones, aplicar reglas de negocio, y coordinar acceso a datos.
- Auth Service: Módulo o servicio dedicado a verificar identidades y emitir tokens. — Ser la única fuente de verdad sobre quién puede acceder al sistema.
- PostgreSQL: Sistema de gestión de base de datos relacional (RDBMS). — Almacenar y recuperar datos de forma persistente, consistente y transaccional.
- Logging: Infraestructura de logging que recibe, almacena y permite consultar logs. — Dar visibilidad al comportamiento del sistema en producción.
Escenarios
- Flujo normal de login y consulta: El usuario se autentica exitosamente y realiza una consulta de datos.
- Falla de base de datos: La base de datos no responde. El sistema entra en degradación.