Crea tu primera API REST con Node.js y Express para tu pyme en Colombia

¡Hola, emprendedores y devs de Colombia! Si tienes un negocio, ya sea una tiendita de barrio, una marca de ropa o una startup en pleno crecimiento, seguro te has dado cuenta de que digitalizar tus operaciones no es un lujo, sino una necesidad. Hoy en día, hacerle el quite a la competencia significa tener tus datos organizados y accesibles desde cualquier dispositivo.

En este tutorial práctico desde Camilincanins Company, vamos a meternos de lleno en el mundo del desarrollo backend. Te voy a enseñar cómo crear tu primera API REST utilizando Node.js y Express. La idea es que al final puedas gestionar un inventario básico, un primer paso grandísimo para tu propio software a medida o app móvil. ¡Vamos al lío!

¿Qué es una API REST y por qué la necesitas?

Antes de tirar líneas de código, hagamos el parallevar. Imagina que entras a un restaurante en el centro de Bogotá o en el Poblado de Medellín. Tú (el cliente o la app móvil) le pides el menú al mesero (la API). El mesero va a la cocina (el servidor o base de datos), pide tu bandeja paisa y te la trae de vuelta. Tú no tienes que saber cómo se preparó el plato, solo lo pides y te lo entregan.

Una API REST funciona igual. Es un puente que permite que tu aplicación web o móvil se comunique con tu base de datos de forma ordenada y estandarizada. Esto te permite tener tu inventario en la nube y consultarlo desde una página web, una app en Android o iOS, o incluso desde un videojuego si estás vendiendo skins o items.

Preparando el terreno (Requisitos previos)

Para este tutorial, solo necesitas tres cosas:

Paso 1: Inicializar el proyecto

Abre tu terminal (o la terminal integrada de VS Code) y crea una nueva carpeta para tu proyecto. Navega hacia ella e inicializa el proyecto de Node con el siguiente comando:

mkdir api-inventario-col
cd api-inventario-col
npm init -y

El comando npm init -y crea un archivo package.json que guardará la información de tu proyecto y las dependencias que vayas a instalar. Ahora, vamos a instalar Express, que es el framework que nos hará la vida muchísimo más fácil para crear rutas:

npm install express

Paso 2: Crear el servidor básico

Crea un archivo en la raíz de tu carpeta llamado index.js. Este será el corazón de nuestra API. Abre el archivo y pega el siguiente código:

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

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

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

Para probar que todo está chevere, ve a tu terminal y ejecuta node index.js. Deberías ver el mensaje "Servidor corriendo en http://localhost:3000". Si es así, ¡felicitaciones, ya tienes un servidor local funcionando!

Paso 3: Definir las rutas (CRUD básico)

Un buen inventario debe permitir Crear, Leer, Actualizar y Borrar productos (lo que llamamos CRUD, por sus siglas en inglés). Para este ejemplo, vamos a usar un arreglo en memoria para guardar nuestros productos. En la vida real, usarías una base de datos como MongoDB o PostgreSQL, pero para empezar, esto está perfecto.

Añade este código justo antes de app.listen en tu archivo index.js:

let productos = [
{ id: 1, nombre: "Arepas de maíz", precio: 3000, stock: 50 },
{ id: 2, nombre: "Café tinto 500g", precio: 15000, stock: 20 }
];

// Leer todos los productos (GET)
app.get('/productos', (req, res) => {
res.json(productos);
});

// Crear un nuevo producto (POST)
app.post('/productos', (req, res) => {
const nuevoProducto = {
id: productos.length + 1,
nombre: req.body.nombre,
precio: req.body.precio,
stock: req.body.stock
};
productos.push(nuevoProducto);
res.status(201).json({ mensaje: "Producto agregado con éxito", producto: nuevoProducto });
});

// Actualizar un producto (PUT)
app.put('/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({ mensaje: "Producto actualizado", producto: productos[index] });
} else {
res.status(404).json({ error: "Producto no encontrado, parcero" });
}
});

// Eliminar un producto (DELETE)
app.delete('/productos/:id', (req, res) => {
const id = parseInt(req.params.id);
productos = productos.filter(p => p.id !== id);
res.json({ mensaje: "Producto eliminado de la base" });
});

Paso 4: Probar nuestra API

Para probar estos endpoints sin tener que construir una interfaz gráfica todavía, puedes usar herramientas como Postman o la extensión Thunder Client dentro de VS Code.

Consejos prácticos para el contexto colombiano

Como emprendedor o desarrollador en Colombia, debes pensar en la conectividad. No todos tus clientes tendrán fibra óptica o 5G. Mantén tus respuestas de API ligeras (no envíes datos de más). Además, siempre piensa en la seguridad: más adelante deberás implementar JWT (JSON Web Tokens) para que nadie ajeno pueda modificar el inventario de tu negocio. La ciberseguridad es un tema que no podemos tomar a la ligera.

Conclusión

Construir tu propia API REST es el primer paso gigante para tomar el control total de la tecnología de tu negocio. Ya viste que con Node.js y Express no es ciencia espacial y puedes empezar a estructurar tus datos hoy mismo. A partir de aquí, las posibilidades son infinitas: puedes conectar esta API a una app móvil hecha en Flutter o React Native, o a una página web en React.

Sin embargo, sabemos que el tiempo es oro para un emprendedor. Si te trabas en el camino, necesitas conectar esto con una base de datos real, o prefieres enfocarte en vender mientras un equipo experto construye tu software a medida, en Camilincanins Company estamos listos para echarte una mano. Ya sea en desarrollo web, apps móviles, videojuegos o consultoría, podemos escalar tu idea al siguiente nivel. ¡Contáctanos y conversemos sobre tu próximo proyecto!

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

Solicitar cotización gratis 🦎