Tema 14 · API REST & CRUD

14. Construcción de una API RESTful con Express: CRUD Completo, express.json() y CORS

Desarrolla una API REST completa con operaciones GET, POST, PUT, DELETE, parseo automático de JSON en el cuerpo de la petición y configuración de CORS.

Principios de una API RESTful en Express

Una API RESTful utiliza las convenciones universales del protocolo HTTP: nombres de recursos en sustantivos plurales (ej. /api/estudiantes) y los verbos estándar para las operaciones CRUD (Create, Read, Update, Delete).

Verbo HTTP Endpoint Acción CRUD Código de Estado Típico
GET/api/estudiantesListar todos200 OK
GET/api/estudiantes/:idDetalle de uno200 OK / 404 Not Found
POST/api/estudiantesCrear nuevo201 Created / 400 Bad Request
PUT / PATCH/api/estudiantes/:idActualizar200 OK
DELETE/api/estudiantes/:idEliminar200 OK / 204 No Content

El Reto de CORS (Cross-Origin Resource Sharing)

Por seguridad, los navegadores bloquean cualquier petición AJAX/Fetch realizada desde un origen distinto (ej. tu frontend en localhost:5173 o app.kilopolis.com intentando consultar la API en api.kilopolis.com).

En Express se resuelve elegantemente con el paquete oficial cors:

import cors from 'cors';

// Permite peticiones únicamente desde el dominio autorizado
app.use(cors({
  origin: ['https://kilopolis.com', 'http://localhost:5173'],
  methods: ['GET', 'POST', 'PUT', 'DELETE'],
  credentials: true
}));

⚡ API RESTful CRUD Completa en un Solo Archivo Express

Servicio REST listo para producción con validaciones, códigos de estado precisos y CORS:

estudiantes-api.js
Solo lectura
// estudiantes-api.js - API REST CRUD Completa con Express
import express from 'express';
import cors from 'cors';

const app = express();
app.use(cors());
app.use(express.json());

// Simulación de base de datos
let estudiantes = [
  { id: 1, nombre: 'Valentina Rodríguez', email: '[email protected]', activo: true },
  { id: 2, nombre: 'Santiago Castro', email: '[email protected]', activo: true }
];

// 1. READ ALL (GET)
app.get('/api/estudiantes', (req, res) => {
  res.json({ total: estudiantes.length, datos: estudiantes });
});

// 2. READ ONE (GET /:id)
app.get('/api/estudiantes/:id', (req, res) => {
  const id = parseInt(req.params.id, 10);
  const alumno = estudiantes.find(e => e.id === id);
  if (!alumno) return res.status(404).json({ error: 'Estudiante no encontrado' });
  res.json(alumno);
});

// 3. CREATE (POST)
app.post('/api/estudiantes', (req, res) => {
  const { nombre, email } = req.body;
  if (!nombre || !email) {
    return res.status(400).json({ error: 'Nombre y email son requeridos' });
  }

  const nuevo = { id: Date.now(), nombre, email, activo: true };
  estudiantes.push(nuevo);
  res.status(201).json({ mensaje: 'Creado con éxito', estudiante: nuevo });
});

// 4. UPDATE (PUT /:id)
app.put('/api/estudiantes/:id', (req, res) => {
  const id = parseInt(req.params.id, 10);
  const index = estudiantes.findIndex(e => e.id === id);
  if (index === -1) return res.status(404).json({ error: 'Estudiante no encontrado' });

  const { nombre, email, activo } = req.body;
  estudiantes[index] = {
    ...estudiantes[index],
    nombre: nombre || estudiantes[index].nombre,
    email: email || estudiantes[index].email,
    activo: activo !== undefined ? Boolean(activo) : estudiantes[index].activo
  };

  res.json({ mensaje: 'Actualizado con éxito', estudiante: estudiantes[index] });
});

// 5. DELETE (DELETE /:id)
app.delete('/api/estudiantes/:id', (req, res) => {
  const id = parseInt(req.params.id, 10);
  const previo = estudiantes.length;
  estudiantes = estudiantes.filter(e => e.id !== id);

  if (estudiantes.length === previo) {
    return res.status(404).json({ error: 'Estudiante no encontrado' });
  }

  res.json({ mensaje: `Estudiante con ID ${id} eliminado con éxito` });
});

app.listen(3000, () => console.log('API REST activa en puerto 3000'));
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Cuál es el código de estado HTTP adecuado que una API REST debe devolver tras crear exitosamente un nuevo recurso con el método POST?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar Node.js & npm Profesional y crear proyectos reales?

Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.