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/estudiantes | Listar todos | 200 OK |
| GET | /api/estudiantes/:id | Detalle de uno | 200 OK / 404 Not Found |
| POST | /api/estudiantes | Crear nuevo | 201 Created / 400 Bad Request |
| PUT / PATCH | /api/estudiantes/:id | Actualizar | 200 OK |
| DELETE | /api/estudiantes/:id | Eliminar | 200 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 - 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¿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.