Las APIs impulsan la mayoría de las aplicaciones que usamos a diario, desde redes sociales hasta apps del clima. Una API REST Representational State Transfer es una forma común y sencilla de permitir que aplicaciones se comuniquen entre sí. En esta guía práctica te acompaño paso a paso para crear una API REST con Node.js y Express, ideal para quienes comienzan y para equipos que buscan construir aplicaciones a medida y software a medida de forma rápida y escalable.
Lo que aprenderás
- Qué es una API REST
- Cómo preparar Node.js y Express
- Cómo crear rutas para operaciones CRUD Crear, Leer, Actualizar, Eliminar
- Cómo probar tu API con herramientas como Postman o curl
Paso 1 Inicializa tu proyecto
Crea una carpeta de proyecto y arranca npm:
mkdir rest-api-demo
cd rest-api-demo
npm init -y
Instala Express:
npm install express
Paso 2 Crea el servidor
Crea un archivo llamado server.js y define un servidor básico con Express:
const express = require(`express`);
const app = express();
const PORT = 3000;
app.use(express.json());
app.listen(PORT, () => { console.log(`Servidor ejecutándose en https://localhost:${PORT}`); });
Ejecuta tu servidor
node server.js
Deberías ver en la consola
Servidor ejecutándose en https://localhost:3000
Paso 3 Crea rutas CRUD
Construyamos una API sencilla para gestionar una lista de libros:
let books = [
{ id: 1, title: `Atomic Habits`, author: `James Clear` },
{ id: 2, title: `The Pragmatic Programmer`, author: `Andrew Hunt` }
];
// Obtener todos los libros
app.get(`/books`, (req, res) => { res.json(books); });
// Obtener un libro por ID
app.get(`/books/:id`, (req, res) => { const book = books.find(b => b.id === parseInt(req.params.id)); if (book) { res.json(book); } else { res.status(404).json({ message: `Libro no encontrado` }); } });
// Agregar un nuevo libro
app.post(`/books`, (req, res) => { const newBook = { id: books.length + 1, title: req.body.title, author: req.body.author }; books.push(newBook); res.status(201).json(newBook); });
// Actualizar un libro existente
app.put(`/books/:id`, (req, res) => { const book = books.find(b => b.id === parseInt(req.params.id)); if (!book) return res.status(404).json({ message: `Libro no encontrado` }); book.title = req.body.title; book.author = req.body.author; res.json(book); });
// Eliminar un libro
app.delete(`/books/:id`, (req, res) => { books = books.filter(b => b.id !== parseInt(req.params.id)); res.json({ message: `Libro eliminado` }); });
Paso 4 Prueba tu API
Usa Postman o curl para verificar los endpoints:
GET /books Obtener todos los libros
GET /books/1 Obtener el libro con ID 1
POST /books con cuerpo JSON Agregar un nuevo libro
PUT /books/1 con cuerpo JSON Actualizar el libro con ID 1
DELETE /books/1 Eliminar el libro con ID 1
Paso 5 Próximos pasos
Ya creaste tu primera API REST con Node.js y Express. El siguiente paso natural es conectar una base de datos como MongoDB o PostgreSQL, añadir autenticación con JWT u OAuth, implementar validaciones y desplegar en la nube para escalar. Si tu empresa necesita acelerar este proceso con aplicaciones a medida y software a medida, en Q2BSTUDIO te ayudamos de extremo a extremo con arquitectura, desarrollo, pruebas, despliegue y observabilidad.
Por qué Q2BSTUDIO
- Experiencia en construcción de APIs seguras y escalables
- Especialistas en inteligencia artificial, ia para empresas y agentes IA para automatizar procesos y mejorar la toma de decisiones
- Enfoque integral en ciberseguridad incluyendo prácticas de hardening y pentesting
- Servicios cloud aws y azure para despliegues resilientes y de alto rendimiento
- Servicios inteligencia de negocio y analítica con power bi para transformar datos en decisiones
Si buscas un partner para crear tu plataforma o modernizar sistemas legados, explora nuestro desarrollo de aplicaciones a medida y software a medida. Y cuando llegue el momento de llevar tu API a producción con alta disponibilidad, nuestros servicios cloud aws y azure te permiten automatizar despliegues, observabilidad y escalado bajo demanda.
Consejos extra
- Versiona tu API v1 v2 con prefijos de ruta
- Añade middlewares de validación con librerías como joi o zod
- Centraliza el manejo de errores y logs
- Documenta con OpenAPI Swagger para facilitar el consumo
- Protege con rate limiting, CORS y autenticación
Con estos fundamentos podrás construir APIs que sirvan como columna vertebral de productos digitales, integraciones B2B y soluciones de automatización que aprovechen inteligencia artificial, ciberseguridad de primer nivel y analítica avanzada con power bi, impulsando el crecimiento sostenible de tu negocio.