Cómo montar tu primera API REST con Node.js para digitalizar tu negocio

Si tienes un pequeño negocio en Colombia, seguro ya te has dado cuenta de que llevar las cuentas en cuadernos o en hojas de Excel ya no es suficiente. Tus clientes están en sus teléfonos y esperan que puedas atenderlos rápido, ya sea para ver un catálogo, hacer un pedido o agendar un servicio. Dar el salto a la digitalización no tiene por qué ser un dolor de cabeza ni requerir un presupuesto inmenso desde el primer día.

En este tutorial práctico vamos a construir el corazón de cualquier aplicación moderna: una API REST. Piensa en la API como el puente que conecta tu página web o tu app móvil con la base de datos donde guardas la información de tus productos. Usaremos Node.js y Express, herramientas potentes, gratuitas y muy amigables para quienes están empezando en el mundo del desarrollo de software.

¿Por qué Node.js y Express para tu emprendimiento?

Node.js nos permite ejecutar JavaScript en el servidor. Si ya tienes a alguien en tu equipo que sabe un poco de JavaScript para hacer animaciones en una web, ¡ya tiene media carrera ganada para entender el backend! Express, por su parte, es un framework que simplifica muchísimo la creación de rutas y el manejo de peticiones. Es rápido, ligero y tiene una comunidad gigante, lo que significa que si te atascastas, encontrarás solución rápidamente. Es una opción súper práctica para negocios que buscan escalar poco a poco.

Paso 1: Preparar el entorno de desarrollo

Antes de escribir una sola línea de código, necesitamos alistar la herramienta. Lo primero es instalar Node.js en tu computador. Puedes descargarlo desde su página oficial (nodejs.org). Te recomiendo descargar la versión LTS (Long Term Support), que es la más estable.

Una vez instalado, abre tu terminal (o símbolo del sistema en Windows) y verifica que todo quedó bien escribiendo:

node -v

Si te aparece un número de versión, vamos por buen camino. Ahora, crea una carpeta para tu proyecto, entra en ella desde la terminal e inicializa el proyecto con el siguiente comando:

npm init -y

Esto creará un archivo package.json que guardará la información de tu proyecto y las dependencias que vayamos a instalar. Ahora, instalemos Express:

npm install express

Paso 2: Configurar el servidor básico

Vamos a crear el archivo principal de nuestra aplicación. En la carpeta de tu proyecto, crea un archivo llamado index.js. Ábrelo con tu editor de código favorito (como Visual Studio Code) y vamos a escribir el código para levantar nuestro primer servidor:

const express = require('express');
const app = express();
const PORT = 3000;

// Middleware para poder entender los datos en formato JSON
app.use(express.json());

app.listen(PORT, () => {
  console.log(`Servidor corriendo exitosamente en http://localhost:${PORT}`);
});

Para probar esto, ve a tu terminal y ejecuta node index.js. Deberías ver el mensaje "Servidor corriendo exitosamente...". Si es así, ¡felicitaciones! Ya tienes un servidor local funcionando. Para detenerlo, presiona Ctrl + C.

Paso 3: Crear las rutas para gestionar productos

Imaginemos que tienes una tienda de ropa en Medellín o una cafetería en Bogotá y quieres que tu app muestre los productos disponibles. Vamos a crear un arreglo (una lista) en memoria para guardar nuestros productos y crear dos rutas: una para ver los productos y otra para agregar uno nuevo.

Añade este código justo antes de la línea app.listen(...) en tu archivo index.js:

// Nuestra base de datos temporal
let productos = [
  { id: 1, nombre: "Camiseta básica", precio: 35000 },
  { id: 2, nombre: "Taza de café artesanal", precio: 18000 }
];

// Ruta para obtener todos los productos (GET)
app.get('/api/productos', (req, res) => {
  res.status(200).json(productos);
});

// Ruta para agregar 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({ mensaje: "Producto agregado con éxito", producto: nuevoProducto });
});

Aquí estamos diciéndole a nuestro servidor: "Si alguien visita la dirección /api/productos usando el método GET, respóndele con la lista de productos en formato JSON". Y si usan el método POST, tomamos los datos que nos envían (nombre y precio), los guardamos en la lista y confirmamos que se agregó.

Paso 4: Probar nuestra API

Para probar la ruta GET es muy sencillo: con tu servidor corriendo (recuerda ejecutar node index.js), abre tu navegador y ve a http://localhost:3000/api/productos. Verás la lista de productos en la pantalla.

Sin embargo, probar el método POST desde el navegador es más complejo. Para esto, los desarrolladores usamos una herramienta gratuita llamada Postman. Descárgala, ábrela y sigue estos pasos:

{
  "nombre": "Sombrero vueltiao",
  "precio": 120000
}

Si todo salió bien, recibirás una respuesta con estado 201 y el mensaje de éxito. Ya tienes una API capaz de recibir y devolver información, lista para ser conectada a un frontend en React, Vue o una app móvil en Flutter.

Consejos prácticos para llevar tu API a producción

Alistar la API en tu computador es apenas el primer paso. Antes de lanzar tu producto al mercado colombiano, ten en cuenta estos consejos:

Conclusión y próximos pasos

Digitalizar tu negocio construyendo tu propia infraestructura es un camino emocionante. Con Node.js y Express has dado el primer paso creando una API funcional que puede gestionar el inventario de tu emprendimiento. La clave del desarrollo de software es ir iterando: empieza pequeño, prueba constantemente y ve agregando funcionalidades según lo que tus clientes te pidan.

Sin embargo, sabemos que como emprendedor tu tiempo es oro y a veces las exigencias técnicas pueden abrumar. Si quieres llevar tu idea al siguiente nivel pero prefieres enfocarte en lo que mejor sabes hacer —tu negocio—, en Camilincanins Company estamos listos para echarte una mano. Ya sea para desarrollar tu app móvil, tu página web o un software a la medida, nuestro equipo te acompañará con un trato cercano y profesional para que tu proyecto sea un éxito en Colombia. ¡Hablemos sobre tu próxima idea!

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

Solicitar cotización gratis 🦎