Operaciones CRUD en APIs REST con Postman

Clase 4 de 35 • Curso de Backend con NestJS

Resumen

Comprender el ciclo completo de operaciones CRUD en APIs REST es clave al desarrollar servicios modernos. Este contenido aborda de forma práctica cómo implementar las etapas de create, read y delete usando ejemplos reales y buenas prácticas. Además, muestra el valor de herramientas como Postman para testear y optimizar endpoints, facilitando la exploración evitando depender solo de un navegador.

¿Qué son las CRUD Operations y por qué son esenciales en una API REST?

Las CRUD Operations permiten manipular recursos en una API REST bajo los métodos create, read, update y delete. Hasta este punto, el enfoque ha estado en el método read, accediendo a usuarios individuales o múltiples. Sin embargo, integrar el resto de operaciones permite modificar, eliminar y crear usuarios, ajustando los datos conforme a las necesidades de cada negocio.

¿Cómo probar correctamente los endpoints de una API REST?

Aunque el navegador sirve para pruebas iniciales, resulta limitado para ciertos métodos como post y delete. Por esto, se recomienda usar herramientas especializadas como Postman o Insomnia. Postman ofrece una interfaz sencilla para:

Crear colecciones y organizar requests.
Cambiar protocolos entre get, post, y delete.
Enviar información mediante query parameters, headers o el body en formato JSON.
Visualizar respuestas, status codes y dejar notas aclaratorias.

¿Cómo manejar respuestas y validar la existencia de usuarios en los endpoints?

Implementar respuestas claras mejora la experiencia del usuario y facilita el debugging. Por ejemplo:

Cuando un usuario no existe, retornar un mensaje como "User not found" evita enviar respuestas vacías.
Para métodos get, se utiliza el status code 200 si la búsqueda fue correcta. Sin embargo, si no se encuentra el recurso, la respuesta idealmente debe ser diferente (aspecto a perfeccionar).

¿Qué consideraciones hay al crear un usuario mediante post?

Al usar el método post para crear usuarios:

Se envía la información del usuario (ID, nombre y email) en el body del request, usualmente formateado en JSON.
La API debería devolver el objeto creado, confirmando la acción.
NestJS, por convención, responde con el status code 201 cuando se crea un recurso exitosamente.
La información agregada permanece solo en memoria, por lo que cambios en el código reinician los datos por defecto.

¿Cómo funciona la eliminación de usuarios con delete y cuáles son las mejores prácticas?

El método delete funciona de manera análoga al get, solicitando el ID del usuario a eliminar como parámetro:

La implementación puede aprovechar métodos como filter o splice de JavaScript para actualizar el arreglo de usuarios.
Si el usuario existe, se devuelve un mensaje como "usuario eliminado" y un status code 200.
Si el usuario no se encuentra, el mensaje debe ser "User not found".
Es recomendable validar previamente la existencia del usuario antes de intentar eliminarlo, evitando respuestas poco precisas.

¿Cómo automatizar el generamiento de IDs al crear usuarios?

Se plantea el reto de autogenerar el ID de un usuario, evitando que se envíe manualmente en el body. Algunas alternativas para un array en memoria incluyen:

Asignar el siguiente número entero según la cantidad de usuarios existentes.
Generar un string o número randómico único.

De este modo, el backend mantendría la integridad de los identificadores, simplificando los requests y fortaleciendo la lógica de la API.

¿Has utilizado alguna técnica diferente para gestionar los IDs de tus usuarios? Comparte tus hallazgos y seguimos aprendiendo juntos.

Osvaldo Frias

student•

Para el reto hice lo siguiente:

  nextUserId(): string {
    const lastIdx = this.users.sort((a, b) => parseInt(b.id) - parseInt(a.id))[0].id;
    return (parseInt(lastIdx) + 1).toString();
  }

  @Post()
  createUser(@Body() body: User): User {
    const nextId = this.nextUserId();
    this.users.push({ ...body, id: nextId });
    return body;
  }

Alexander Flores Rayme

student•

el reto: como hacer mejor una mala practica 😑

Jesus Gabriel Perez

student••

@Post()
  createUser(@Body() body: User) {

    const idAuto = this.users.findLast(user => user.id);
    if (idAuto) {
      body.id = idAuto.id + 1;
    }
    this.users.push(body);
    return body;
  }

Busco el id del último user creado y luego le sumo +1, así siempre serán autoincrementables. Esto con el mismo array static de users que ya tenemos creado.

Alejandro Mira

student•

Para el reto trate de hacerlo mas sencillo posible:

@Post()
  createUser(@Body() user: Users) {
    const id: string = String(this.users.length + 1);
    this.users.push({ ...user, id });
    return user;
  }

Nicolas Molina

teacher•

¡Genial! Si correcto, esa es una forma y funciona.

William Javier Del Valle Meza

student••

Funciona porque el id no es único, pero si creas 3, borras el primero que creaste y vuelves a crear uno te quedarían 2 usuarios con el id = 3.

Lo mejor sería no hacerlo con length sino buscar el id mayor y sumarle 1.

@Post()
createUser(@Body() user: User) {
  const newId = Math.max(...this.users.map((u) => parseInt(u.id))) + 1;
  user.id = newId.toString();

  this.users.push(user);
  return user;
}

Francisco Antonio Hernandez Sabatino

student•

@Post('/')
  createUser(@Body() newUser: IUser, @Res() res: Response) {
    try {
      const user: IUser | undefined = this.users.find((user) => user.email === newUser.email);
      // Check if duplicated
      if (user) {
        res.status(HttpStatus.CONFLICT).json({ message: 'id or email alredy in use' });
      }
      const newUserId: number = Number(this.users[this.users.length - 1].id) + 1;
      newUser.id = `${newUserId}`;
      this.users.push(newUser);
      res.status(HttpStatus.CREATED).send();
    } catch (err) {
      console.log(err);
      // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
      res.status(HttpStatus.BAD_REQUEST).json({ message: err });
    }
  }

  @Delete('/:id')
  deleteUser(@Param('id') id: string, @Res() res: Response) {
    const userIndex = this.users.findIndex((user) => user.id === id);

    if (userIndex === -1) {
      return res.status(HttpStatus.NOT_FOUND).json({
        message: `Usuario con ID '${id}' no encontrado.`,
      });
    }
    this.users = this.users.filter((user) => user.id !== id);
    return res.status(HttpStatus.NO_CONTENT).send();
  }

Maria Alejandra Luna Tito

student•

el método push retorna el nro de elementos del array es decir el length

Vee Pabuence Vargas

student•

Mi forma de resolver el reto, no creo que sea la más optima jeje

Exneider Villalba

student•

@Post()

createUser(@Body() body: User): User {

body.id = this.users.length + 1;

this.users.push(body);

return body;

}

Alan Damian Fernandez

student•

Generé el ID tomando el mayor valor existente en la lista de usuarios y sumándole 1, garantizando así que siempre sea incremental. Además, agregué una verificación de email duplicado para evitar registros repetidos y mejorar la consistencia de los datos.

fragmento de la solución

@Post()
createUser(@Body() body: Omit<User, 'id'>): User {
  // Validar email duplicado
  const exists = this.users.some((u) => u.email === body.email);
  if (exists) {
    throw new BadRequestException('El email ya está en uso');
  }

  // Generar ID automáticamente
  const newId = (
    Math.max(...this.users.map((u) => parseInt(u.id)), 0) + 1
  ).toString();

  const newUser: User = {
    id: newId,
    name: body.name,
    email: body.email,
  };

  this.users.push(newUser);
  return newUser;
}

Carlos Rodríguez

student•

Lo más común en el método DELETE es un Status 204, No Content