Cómo crear tu primera API REST con Node.js y Express: Guía paso a paso para emprendedores

¿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:

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:

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:

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!

¿Tienes un proyecto en mente? Te ayudamos a hacerlo realidad.

Solicitar cotización gratis 🦎