Node.js y APIs con Express

Este curso construye una API de aprendizaje paso a paso, desde el comportamiento del runtime hasta las decisiones que permiten operarla con seguridad y observarla. El escenario común será una plataforma local de cursos con recursos como cursos, notas y elementos paginados. No se trata de copiar una arquitectura completa, sino de entender qué responsabilidad pertenece a cada capa y cómo verificarla con entradas pequeñas y resultados reproducibles.

En el primer módulo estudiarás Node como entorno de ejecución. Relacionarás el event loop con tareas de entrada y salida, distinguirás microtareas de macrotareas y aprenderás a detectar trabajo síncrono que bloquea el proceso. Después separarás el arranque del servidor, la configuración y el código de aplicación. Las variables de entorno se validarán al inicio, sin guardar secretos en el repositorio. Finalmente compararás operaciones asíncronas secuenciales y paralelas, y establecerás una ruta única para propagar errores.

El módulo de Express convierte esas bases en un contrato HTTP. Diseñarás rutas centradas en recursos, métodos y estados de respuesta, y separarás routers para evitar una aplicación difícil de recorrer. Los middlewares servirán para registrar solicitudes, autenticar una petición ya verificada y centralizar fallos. La validación añadirá una frontera explícita entre datos externos y lógica de negocio: un cliente recibirá códigos y mensajes previsibles, nunca un volcado accidental de la pila.

A continuación conectarás la API con Postgres mediante un pool y consultas parametrizadas. La decisión importante no es solo abrir una conexión, sino controlar concurrencia, parámetros y tiempos de espera. En autenticación distinguirás identidad de autorización: el sistema debe conocer quién solicita una operación y comprobar si puede acceder al recurso. El código de ejemplo no inventará criptografía ni presentará un login incompleto como solución lista para producción. En paginación compararás límite, cursor y orden estable con registros concretos, comprobando que no se repiten ni desaparecen elementos entre páginas.

El último módulo trata la operación cotidiana. Un log útil relaciona solicitud, estado y duración sin exponer tokens ni contraseñas. Un límite de frecuencia se definirá según el tipo de endpoint y responderá con 429 cuando corresponda; también considerarás cómo el cliente debe interpretar ese resultado. Por último documentarás contratos, ejemplos válidos y errores para que otra persona pueda probar la API sin adivinar nombres de campos o estados.

El trabajo final será una API local de cursos con al menos un recurso principal, configuración separada, validación, autorización de propiedad, consulta parametrizada, paginación por cursor, logs con identificador de solicitud, límites diferenciados y documentación de sus endpoints. Cada decisión se comprobará con casos normales y casos de fallo: configuración ausente, entrada inválida, recurso inexistente, acceso ajeno, cursor repetido y exceso de solicitudes. El resultado no se evaluará por cantidad de código, sino por la trazabilidad entre requisito, respuesta HTTP, datos utilizados y prueba reproducible. Conserva las entradas de cada prueba, la salida observada y la razón de cada estado elegido.