¿Tienes una idea genial para una app móvil o una página web para tu negocio en Colombia, pero no sabes por dónde empezar con el backend? No te preocupes, aquí estamos para ayudarte a dar ese primer paso. Uno de los pilares de cualquier aplicación moderna es una API (Application Programming Interface) que permita a tu frontend comunicarse con tus datos y lógica de negocio. Hoy vamos a construir tu primera API REST usando Node.js y Express. Es más sencillo de lo que parece y te dará la base sólida para escalar tu proyecto.
¿Qué necesitas antes de empezar?
Antes de ponernos manos a la obra, asegúrate de tener lo siguiente en tu computador:
- Node.js instalado: Puedes descargarlo desde su página oficial. Te recomiendo la versión LTS (Long Term Support) para mayor estabilidad.
- Un editor de código: Personalmente recomiendo Visual Studio Code (VS Code), es ligero, gratuito y tiene miles de extensiones útiles.
- Un cliente de APIs: Para probar que todo funcione, descarga Postman, Insomnia o usa la extensión Thunder Client en VS Code.
- Ganas de aprender: Y por qué no, un buen tintico al lado para ir tomando mientras programamos.
Paso 1: Inicializar tu proyecto
Lo primero que debemos hacer es crear una carpeta para nuestro proyecto y abrir una terminal en esa ubicación. Una vez allí, vamos a inicializar un proyecto de Node.js e instalar Express, que es el framework que nos facilitará la vida para crear el servidor.
En tu terminal, ejecuta los siguientes comandos:
mkdir mi-api-negocio
cd mi-api-negocio
npm init -y
npm install express
El comando npm init -y crea un archivo package.json con la configuración básica de tu proyecto. Luego, al instalar Express, se agregará a las dependencias de tu proyecto. ¡Listo! Ya tenemos el esqueleto de nuestra aplicación.
Paso 2: Escribir el código del servidor
Ahora, abre la carpeta en VS Code y crea un archivo llamado index.js en la raíz del proyecto. Este será el punto de entrada de nuestra API. Vamos a escribir el código básico para levantar un servidor web.
const express = require('express');
const app = express();
const port = 3000;
// Middleware para poder leer JSON en las peticiones
app.use(express.json());
app.listen(port, () => {
console.log(`La API está corriendo en http://localhost:${port}`);
});
Aquí estamos importando Express, inicializándolo y configurando un puerto (el 3000 es muy común para desarrollo local). El middleware app.use(express.json()) es súper importante: le dice a nuestro servidor que entienda las peticiones que vengan con datos en formato JSON, que es el estándar hoy en día.
Paso 3: Implementar el CRUD (Crear, Leer, Actualizar, Borrar)
Para que nuestra API sea útil, necesitamos manejar datos. En un proyecto real conectarías una base de datos (como PostgreSQL o MongoDB), pero para este tutorial usaremos un arreglo en memoria. Imaginemos que tienes un emprendimiento de venta de productos artesanales colombianos y necesitas gestionar tu inventario.
Añade el siguiente código a tu archivo index.js, justo antes de la línea app.listen:
let productos = [
{ id: 1, nombre: 'Mochila Wayuu', precio: 150000 },
{ id: 2, nombre: 'Sombrero Vueltiao', precio: 90000 }
];
// Leer todos los productos (GET)
app.get('/api/productos', (req, res) => {
res.json(productos);
});
// Crear un nuevo producto (POST)
app.post('/api/productos', (req, res) => {
const nuevoProducto = {
id: productos.length + 1,
nombre: req.body.nombre,
precio: req.body.precio
};
productos.push(nuevoProducto);
res.status(201).json(nuevoProducto);
});
// Actualizar un producto (PUT)
app.put('/api/productos/:id', (req, res) => {
const id = parseInt(req.params.id);
const index = productos.findIndex(p => p.id === id);
if (index !== -1) {
productos[index] = { ...productos[index], ...req.body };
res.json(productos[index]);
} else {
res.status(404).json({ mensaje: 'Producto no encontrado, parce' });
}
});
// Eliminar un producto (DELETE)
app.delete('/api/productos/:id', (req, res) => {
const id = parseInt(req.params.id);
productos = productos.filter(p => p.id !== id);
res.status(204).send();
});
¿Qué hicimos aquí? Implementamos las cuatro operaciones básicas de una API REST, conocidas como CRUD. Usamos las rutas /api/productos y los métodos HTTP correspondientes: GET para obtener datos, POST para crear, PUT para actualizar y DELETE para borrar. Nota cómo usamos req.body para recibir los datos enviados por el cliente y req.params para capturar el ID del producto en la URL.
Paso 4: Probar tu API
Para ver tu creación en acción, ve a la terminal y ejecuta node index.js. Deberías ver el mensaje "La API está corriendo en http://localhost:3000". Ahora abre tu cliente de APIs (Postman o Thunder Client) y haz las siguientes pruebas:
- GET a
http://localhost:3000/api/productos: Deberías ver el arreglo con la mochila Wayuu y el sombrero Vueltiao. - POST a
http://localhost:3000/api/productos: En el body, manda un JSON como{"nombre": "Carriel Antioqueño", "precio": 120000}. Al enviarlo, verás que te devuelve el producto creado con su ID. - PUT a
http://localhost:3000/api/productos/3: Envía un JSON modificando el precio y verás cómo se actualiza en la lista.
Si todo te respondió bien, ¡felicidades! Acabas de construir y probar tu primera API REST funcional.
Consejos prácticos para emprendedores colombianos
Ahora que tienes la base, te dejo algunos consejos para que tu proyecto despegue de manera profesional:
- No te quedes con el arreglo en memoria: Cuando reinicies el servidor, los datos se perderán. Investiga cómo conectar una base de datos. MongoDB Atlas es una excelente opción gratuita para empezar.
- Agrega seguridad: Cuando vayas a producción, instala un paquete llamado
corspara controlar quién puede acceder a tu API, y considera usar JWT (JSON Web Tokens) para autenticar a tus usuarios. - Usa variables de entorno: Instala
dotenvpara guardar tus contraseñas y configuraciones sensibles en un archivo.env. Nunca subas este archivo a tu repositorio de Git. - Despliega tu API: Hay plataformas gratuitas y muy chéveres como Render o Vercel donde puedes subir tu código y tener tu API disponible en internet 24/7 para conectarla con tu app o página web.
Conclusión y próximos pasos
Construir una API REST es un paso fundamental en el desarrollo de software moderno. Hoy aprendiste a levantar un servidor, manejar rutas y operar datos usando Node.js y Express. Este conocimiento te abre las puertas para crear aplicaciones móviles, plataformas web y software a medida que realmente solucionen problemas y hagan crecer tu negocio.
Sabemos que como emprendedor en Colombia, tu tiempo es oro y a veces las exigencias técnicas pueden abrumar. Si ya tienes una idea clara y necesitas que tu plataforma escale, tenga una base de datos robusta y un diseño impecable, no dudes en buscar ayuda de expertos. En Camilincanins Company, fundada por Milo, somos especialistas en desarrollo de software a medida, apps móviles y páginas web. Estamos listos para acompañarte en ese siguiente paso y hacer que tu visión se convierta en realidad. ¡Hablamos pronto!