DTOs y validación automática de datos en APIs con 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:0019:31

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

Curso de Backend con NestJS

Clase 7 de 35

Clase 7 / 35

Recursos

La validación de datos es esencial en cualquier API para garantizar integridad y coherencia antes de procesar información o ejecutar lógica de negocio. Aquí aprenderás a escalar la validación usando NestJS, implementando Data Transfer Objects (DTOs) y los paquetes class-validator y class-transformer para profesionalizar tu capa de validación sin depender de validaciones manuales.

¿Por qué es importante la validación de datos en el controller de NestJS?

El controller es el punto de entrada que protege tus datos y decide si están correctos o si se presentan errores, como datos mal formados o acceso no autorizado. Cuando la validación se hace manualmente, por ejemplo verificando el email campo por campo, el proceso resulta poco escalable y repetitivo. Por eso es necesario un mecanismo más automatizado y robusto.

¿Cómo se usan los DTOs y los decoradores en NestJS para la validación?

Los DTOs definen la estructura y reglas de los datos que recibe tu API, permitiendo validaciones automáticas tanto para query params como para datos en el body.

Se crean como clases en TypeScript, usando decoradores aportados por class-validator.
El nombre más adecuado para un DTO debe describir la acción que realizará, como createUserDTO para creación de usuario.
Los decoradores especifican reglas claras: por ejemplo, que un campo sea string, que no esté vacío, o que el email tenga un formato válido.
Gracias a estos decoradores, no necesitas inventar expresiones regulares ni agregar múltiples condiciones if.

Ejemplo de definición de un DTO:

import { IsString, IsNotEmpty, IsEmail } from 'class-validator';

export class CreateUserDTO {
  @IsString()
  @IsNotEmpty()
  name: string;

  @IsEmail()
  @IsNotEmpty()
  email: string;
}

¿Qué dependencias y configuración inicial necesitas?

Para habilitar esta validación automática deberás instalar dos paquetes esenciales:

class-validator: provee los decoradores para imponer reglas de validación.
class-transformer: permite transformar datos entrantes en instancias de las clases DTO.

Comando de instalación:

npm i --save class-validator class-transformer

También se recomienda trabajar con dos terminales: una para mantener el servidor corriendo y otra para ejecutar instalaciones o cambios.

¿Cómo se configuran y aplican validaciones globales en la API?

Tras crear e importar tus DTOs, la validación se activa de forma global mediante un Validator Pipe.

En tu archivo principal, normalmente main.ts, importa desde common el ValidatorPipe.
Añádelo a la aplicación con app.useGlobalPipes(new ValidatorPipe()) justo después de instanciar la app y antes de escuchar solicitudes.
Así te aseguras de que todas las rutas que usen DTOs validen automáticamente los datos antes de llegar al método del controller.

¿Cómo se interpretan los errores y qué ventajas aporta el sistema de validación?

Cuando los datos no cumplen las reglas, la API devuelve automáticamente un error 400 Bad Request y un mensaje informativo, por ejemplo:

El nombre no debe estar vacío.
El email debe ser un string, no vacío y cumplir el formato adecuado.

Esto elimina la necesidad de escribir condiciones manuales para cada campo. Además, puedes definir mensajes personalizados para cada error, consiguiendo retroalimentación detallada al usuario.

¿Cómo manejar conflictos con ESLint y TypeScript al usar decoradores?

Puede que ESLint marque ciertos usos de decoradores como error por reglas como no-unsafe-call. Si esto impide el correcto uso, puedes añadir una excepción específica en tu archivo eslint.config:

  'no-unsafe-call': 'off',

Procura no deshabilitar todas las reglas y dialoga con tu equipo sobre cuándo amerita hacer excepciones.

¿Cuáles son los siguientes pasos tras crear un DTO para creación de usuario?

El reto siguiente es desarrollar un DTO para actualización de usuario. Este debe validar los mismos campos, pero como opcionales, de modo que no fallen si no se envían y permitan actualizar sólo los datos presentes. ¿Te animas a probarlo en tu proyecto?

Juan Diego Mejia Maestre

Hace 6 meses

🛡️ VALIDACIÓN MAESTRA EN NESTJS

Guía Pro: Implementación de DTOs y Personalización de Errores para APIs robustas.

📦 1. ARQUITECTURA DE VALIDACIÓN

Para que NestJS gestione la seguridad de tus datos, necesitas este combo:

class-validator: Provee la lógica de reglas (decoradores).
class-transformer: Transforma el JSON plano en clases reales.
@nestjs/mapped-types: Para reutilizar esquemas en actualizaciones.

Comando de instalación: npm i class-validator class-transformer @nestjs/mapped-types

🛠️ 2. CONFIGURACIÓN DEL "PIPELINE" GLOBAL

Configura main.ts para que la API responda con un objeto Llave: Valor, ideal para que el Frontend de Quantico sepa exactamente qué input falló.

Código para main.ts:

TypeScript

import { ValidationPipe, BadRequestException } from '@nestjs/common';
import { ValidationError } from 'class-validator';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);

  app.useGlobalPipes(
    new ValidationPipe({
      whitelist: true,
      forbidNonWhitelisted: true,
      transform: true,
      exceptionFactory: (errors: ValidationError[]) => {
        const result = errors.reduce((acc, error) => {
          acc[error.property] = Object.values(error.constraints);
          return acc;
        }, {});
        return new BadRequestException(result);
      },
    }),
  );
  await app.listen(3000);
}

📝 3. MODELADO DE DATOS (DTOs)

🔹 Creación (CreateUserDTO)

Define el "contrato" de entrada para nuevos registros.

TypeScript

import { IsString, IsNotEmpty, IsEmail, MinLength } from 'class-validator';

export class CreateUserDTO {
  @IsString({ message: 'El nombre debe ser texto' })
  @IsNotEmpty()
  name: string;

  @IsEmail({}, { message: 'Email no válido' })
  email: string;

  @MinLength(8, { message: 'Mínimo 8 caracteres' })
  password: string;
}

🔸 Actualización (UpdateUserDTO)

Hereda todo lo anterior pero hace que cada campo sea opcional.

TypeScript

import { PartialType } from '@nestjs/mapped-types';
import { CreateUserDTO } from './create-user.dto';

export class UpdateUserDTO extends PartialType(CreateUserDTO) {}

🚀 4. EL RESULTADO FINAL (UX API)

Cuando alguien envíe datos mal formados, tu API no enviará un texto aburrido, enviará una guía para el frontend:

JSON

{
  "statusCode": 400,
  "message": {
    "email": ["Email no válido"],
    "password": ["Mínimo 8 caracteres"]
  },
  "error": "Bad Request"
}

💡 TIPS PARA TU FLUJO EN OBSIDIAN

🎨 Semántica: Un error 400 significa que el cliente puede arreglarlo; un 500 significa que tú debes arreglar el código.
🧹 Clean Code: Al usar DTOs, tus Controllers quedan limpios: solo reciben el objeto y lo pasan al Service.
⚙️ ESLint: Si los decoradores marcan error, añade 'no-unsafe-call': 'off' en tu config.

Comentarios (14)14 comentarios

JUAN CAMILO CAMPO TANGARIFE

Hace un año

Maria Alejandra Luna Tito

luis alfonso cañari chumpitazi

Hace 3 meses

Jefred Bedoya

Sebastian Pérez

Hace 10 meses

Agustin Zamar

Hace 10 meses•editado

Ulqernesh Karvenae

Hace un mes

Kevin Jeferson Cortes Gomez

Hace 2 meses

Gerardo J. Rito

Andrés Castellanos

David Victoria

Hace un año•editado

Erick Martinez

Estuardo Leonel Lopez Par

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

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