Aprende a Integrar API RESTful con Node.js y Express: Guía Completa y Ejemplos Prácticos

En el mundo del desarrollo web, las APIs (Interfaz de Programación de Aplicaciones) se han convertido en un componente esencial, permitiendo que diferentes aplicaciones se conecten e intercambien datos. En este artículo, profundizaremos en cómo crear e integrar una API RESTful usando Node.js y Express, dos herramientas muy populares en el ecosistema de JavaScript.

¿Qué es una API RESTful?

Una API RESTful es un conjunto de convenciones que permite a las aplicaciones comunicarse entre sí a través de HTTP. REST significa Representational State Transfer y se basa en un modelo de recursos que pueden ser manipulados usando los métodos HTTP más comunes: GET, POST, PUT y DELETE.

¿Por qué usar Node.js y Express?

Node.js: Es un entorno de ejecución de JavaScript del lado del servidor que permite crear aplicaciones escalables y rápidas.
Express: Es un framework minimalista para Node.js que simplifica la creación de aplicaciones web y APIs.

Requisitos Previos

Antes de comenzar, asegúrate de tener instalado Node.js y npm (Node Package Manager) en tu máquina. Puedes descargarlo desde nodejs.org.

Creando un Proyecto Nuevo

mkdir my-api
cd my-api
npm init -y
npm install express

Estructura Básica de la API

Ahora vamos a crear nuestro archivo principal llamado app.js y agregar el siguiente código para establecer nuestros endpoints básicos:

const express = require('express');
const app = express();
const PORT = process.env.PORT || 3000;

app.use(express.json()); // Middleware para parsear JSON

// Endpoint GET
app.get('/api/users', (req, res) => {
  res.send([{ id: 1, name: 'John Doe' }]);
});

// Endpoint POST
app.post('/api/users', (req, res) => {
  const user = req.body;
  // Aquí agregaríamos el código para guardar el usuario en una base de datos
  res.status(201).send(user);
});

app.listen(PORT, () => {
  console.log(`Server is running on http://localhost:${PORT}`);
});

Probar la API

Puedes probar la API usando herramientas como Postman o cURL.

curl -X GET http://localhost:3000/api/users

Conclusión

Crear una API RESTful con Node.js y Express es un proceso sencillo y poderoso. Ahora puedes expandir esta base integrando bases de datos y autenticaciones para crear aplicaciones más robustas.