Creación de endpoints dinámicos para consultar usuarios en NestJS

Contenido del curso

Fundamentos y Primer CRUD

Base de Datos y Persistencia con TypeORM

Autenticación y Autorización

Tu API Completa

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:0020:23

Creación de endpoints dinámicos para consultar usuarios en NestJS

Curso de Backend con NestJS

Clase 3 de 35

Clase 3 / 35

Recursos

Diseñar una API REST eficiente es crucial para cualquier aplicación moderna. Aquí descubrirás, paso a paso, cómo crear endpoints en NestJS que permiten exponer y consultar información de usuarios, desde la definición de controladores hasta la correcta gestión de rutas e identificadores dinámicos.

¿Qué es un endpoint y cómo se consume en un backend?

Un endpoint es el punto de acceso donde los clientes, como aplicaciones móviles o web, se conectan mediante el protocolo HTTP para intercambiar datos con el backend. Diferentes dispositivos pueden consumir estos endpoints para acceder a recursos como listados de usuarios o posts. La solicitud se realiza generalmente por rutas específicas según el servicio que se desea obtener.

Dispositivos conectan a endpoints por HTTP, como /users para obtener usuarios.
Los endpoints retornan la información solicitada, como arrays de objetos en formato JSON.

¿Cómo se configura y ejecuta el servidor en un puerto distinto?

Modificar el puerto de una aplicación puede hacerse desde la terminal utilizando variables de entorno o directamente cambiando la configuración. En el caso de proyectos Node.js, como NestJS, puedes correr el servidor en un puerto diferente con:

npm run start:dev --port=4001 para ejecutar en el puerto 4001.
Usar variables de entorno: export PORT=4000 seguido de npm run start:dev.
Así puedes verificar que ya no responde por el puerto anterior y sí por el nuevo especificado.

¿Para qué sirve un controller en NestJS y cómo se crea?

El controller administra el acceso a los endpoints y conecta las rutas HTTP con la lógica de la aplicación. Usando el CLI de NestJS, puedes generar fácilmente nuevos controladores con comandos como:

nest g controller users para crear user.controller.ts, el archivo de pruebas, y actualizar el app.module.ts.
En este controller, defines rutas y métodos que manejarán las peticiones de los clientes.

¿Cómo se define y utiliza una interfaz en TypeScript para usuarios?

Para aprovechar la verificación de tipos, se recomienda definir una interfaz para los usuarios, por ejemplo:

interface User {
  id: string;
  name: string;
  email: string;
}

Así, un array de usuarios deberá ajustarse al shape definido.
TypeScript previene inserciones incorrectas y ayuda a evitar errores comunes.

¿Cómo se expone el endpoint para obtener la lista de usuarios?

Con el decorador adecuado en el controller, puedes exponer un endpoint accesible mediante HTTP GET, por ejemplo GET /users. Retorna la lista completa de usuarios en formato JSON.

El controller usa decoradores para asociar métodos a rutas y protocolos.
NestJS gestiona el formateo a JSON automáticamente, simplificando el desarrollo.

¿Cómo se crean endpoints dinámicos para buscar usuarios por ID?

Para devolver información de un usuario específico, se define un endpoint con parámetro, como /users/:id. Así se consulta el usuario cuyo identificador coincida con el recibido:

Utiliza dos puntos para indicar un parámetro dinámico en la ruta.
El decorador @Param recupera el valor desde la URL y permite buscar en el array de usuarios.
Devuelve solo el usuario correspondiente, en vez de toda la lista.

¿Qué ocurre si el usuario consultado no existe?

Si se solicita un ID inexistente, la aplicación actualmente no retorna respuesta o muestra una página en blanco. Es esencial manejar este comportamiento para mejorar la experiencia y robustez del servicio.

Situaciones con IDs no encontrados deben ser controladas.
Se plantea el reto de cómo manejar estos casos e invitar a buscar soluciones optimizadas para responder errores de forma adecuada.

¿Te animas a proponer cómo gestionarías los errores cuando el ID del usuario no existe? Tu experiencia y creatividad pueden aportar mucho a la comunidad.

Juan Diego Mejia Maestre

Hace 6 meses•editado

🚀 NestJS: Diseño de API REST y Endpoints

📌 Conceptos Fundamentales

Endpoint: Punto de acceso (URL) donde los clientes (web/móvil) interactúan con el backend mediante el protocolo HTTP.

Flujo de datos: El cliente solicita una ruta (ej. /users) y el servidor responde generalmente con un JSON.

⚙️ Configuración del Servidor

Para cambiar el puerto de ejecución y evitar conflictos:

Vía comandos: npm run start:dev --port=4001

Vía variables de entorno: Bash

export PORT=4000

npm run start:dev

🎮 El Controlador (Controller)

Es el encargado de manejar las peticiones entrantes y retornar las respuestas al cliente.

Generación automática (CLI): Bash

nest g controller users

Esto crea user.controller.ts, su archivo de pruebas y lo registra en app.module.ts.

🛠️ Definición de Estructura (Interface)

Para garantizar la integridad de los datos en TypeScript:

TypeScript

interface User {
  id: string;
  name: string;
  email: string;
}

🛣️ Definición de Endpoints

1. Obtener todos los recursos (GET)

Se utiliza el decorador @Get() para exponer la lista de usuarios.

Ruta: GET /users

Resultado: Array de objetos JSON.

2. Parámetros Dinámicos (GET por ID)

Para buscar un recurso específico se usan los segmentos dinámicos (:id).

Sintaxis en el Controller: TypeScript

```

@Get(':id')
findOne(@Param('id') id: string) {
  // Lógica para buscar el usuario por ID
}

@Get(':id')

```

Decorador @Param: Extrae el valor directamente de la URL.

⚠️ Gestión de Errores

Si un ID no existe, el servidor no debe quedar en silencio. Es fundamental implementar validaciones para retornar códigos de estado HTTP adecuados (ej. 404 Not Found) en lugar de respuestas vacías.

Comentarios (19)19 comentarios

Luis Rosal

Hace un año

John Edwin Torres Martínez

William Javier Del Valle Meza

Vee Pabuence Vargas

Jhorman Salazar

Hace 10 meses•editado

Francisco Antonio Hernandez Sabatino

Hace un año•editado

Juan David Marin Rodriguez

Hace 9 meses•editado

Josué Eliezer Gómez Soto

Deyker Gil

Hace 8 días

Ulqernesh Karvenae

Hace un mes

Etienne Santiago Samboni

Hace 2 meses

Billy Roy Teske Castro

Hace 5 meses

Alejandro Zapata

Hace 7 meses

edward rodriguez

Hace 10 meses

Gerardo Rubio Camacho

Daniel Lucumi

Fundamentos y Primer CRUD

Crea una API RESTful con NestJS

Instalación del CLI de NestJS y primer proyecto con API

Creación de endpoints dinámicos para consultar usuarios en NestJS

Operaciones CRUD en APIs REST con Postman

Método PUT para actualizar usuarios con ID automático

Manejo de status codes HTTP en NestJS

DTOs y validación automática de datos en APIs con NestJS

Servicios y lógica de negocio en NestJS

Variables de entorno seguras en NestJS

Programación modular en NestJS con UserModule

Base de Datos y Persistencia con TypeORM

Configuración de PostgreSQL con Docker y Docker Compose

Configuración de PostgreSQL con TypeORM en aplicaciones NestJS

Creación de entidades ORM con decoradores en TypeScript

Repository Pattern con TypeORM en NestJS

Relaciones uno a uno entre usuarios y perfiles en PostgreSQL

Actualización de DTOs con mapped types en NestJS para perfil y usuario

Generación automática de módulos CRUD con NestJS y AI

Relación uno a muchos con TypeORM

CRUD de categorías con IA en NestJS

Relaciones many-to-many con TypeORM y validación de arrays

Reutilización de servicios entre módulos en NestJS

Migraciones en TypeORM sin perder datos

Cómo evitar perder datos al migrar columnas

Autenticación y Autorización

Hashing de contraseñas con Bcrypt en NestJS

Excluir campos sensibles con ClassTransformer

Autenticación local con Passport en NestJS

Endpoint de login con Passport en NestJS

Implementación de JSON Web Token para autenticación en NestJS

Rutas protegidas con JWT en NestJS

User ID automático desde JWT en NestJS

Tu API Completa

Autogenera resúmenes e imágenes con OpenAI en NestJS

Documentación automática de APIs con Swagger en NestJS

Preparar tu API NestJS para producción

Desplegar aplicación Node.js a producción con Railway y PostgreSQL

Desarrollo de API REST escalable con NestJS en producción

Creación de endpoints dinámicos para consultar usuarios en NestJS