Guía Completa sobre la Creación de APIs RESTful con Node.js y Express

Las APIs RESTful han revolucionado la forma en que los desarrolladores construyen aplicaciones web y móviles. En este artículo, exploraremos cómo crear una API RESTful utilizando Node.js y Express, dos de las herramientas más populares en el desarrollo web moderno.

¿Qué es una API RESTful?

Una API RESTful (Representational State Transfer) permite la comunicación entre diferentes sistemas a través de HTTP. Se caracteriza por operaciones CRUD (Crear, Leer, Actualizar y Eliminar) y utiliza métodos HTTP como GET, POST, PUT y DELETE.

Pre-requisitos

• Conocimientos básicos de JavaScript
• Node.js instalado en tu máquina
• Un editor de código (como Visual Studio Code)

Configurando el entorno

Para comenzar, debemos crear un nuevo proyecto de Node.js. Abre tu terminal y ejecuta el siguiente comando:

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

Esto creará una carpeta para nuestro proyecto y generará un archivo package.json básico. A continuación, instalemos Express:

npm install express

Creando el servidor

Ahora, vamos a crear un servidor básico utilizando Express. Crea un archivo llamado server.js en la raíz de tu proyecto y agrega el siguiente código:

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

app.use(express.json());

app.get('/', (req, res) => {
    res.send('¡Hola, mundo!');
});

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

Para iniciar el servidor, ejecuta el siguiente comando:

node server.js

Implementando rutas CRUD

Ahora agregaremos rutas para manejar operaciones CRUD. A continuación, presentaremos un ejemplo utilizando un recurso ficticio llamado libros:

let libros = [];

app.post('/libros', (req, res) => {
    const libro = req.body;
    libros.push(libro);
    res.status(201).send(libro);
});

app.get('/libros', (req, res) => {
    res.send(libros);
});

app.put('/libros/:id', (req, res) => {
    const { id } = req.params;
    const index = libros.findIndex(l => l.id === id);
    if (index !== -1) {
        libros[index] = req.body;
        res.send(libros[index]);
    } else {
        res.status(404).send('Libro no encontrado');
    }
});

app.delete('/libros/:id', (req, res) => {
    const { id } = req.params;
    libros = libros.filter(l => l.id !== id);
    res.status(204).send();
});

Probando la API

Para probar nuestra API, podemos usar herramientas como Postman o curl. Asegúrate de realizar pruebas de todas las rutas creadas.

Conclusión

Crear una API RESTful con Node.js y Express es un proceso sencillo y directo que te permitirá construir aplicaciones escalables y eficientes. A medida que desarrolles tu API, considera la implementación de autenticación, manejo de errores, y prácticas de seguridad para una solución más robusta.