DRAFT Design Web © · Diseño Web & Software

El desarrollo de APIs (Application Programming Interfaces) se ha convertido en una necesidad fundamental para aplicaciones modernas. En este tutorial, exploraremos cómo crear una API utilizando Node.js, Express y Firebase paso a paso. Este artículo está diseñado para programadores que desean aprender o perfeccionar sus habilidades en el desarrollo backend con herramientas modernas.

El desarrollo de APIs (Application Programming Interfaces) se ha convertido en una necesidad fundamental para aplicaciones modernas. En este tutorial, exploraremos cómo crear una API utilizando Node.js, Express y Firebase paso a paso. Este artículo está diseñado para programadores que desean aprender o perfeccionar sus habilidades en el desarrollo backend con herramientas modernas.

---

Introducción a las herramientas

Node.js

Node.js es un entorno de ejecución de JavaScript que permite desarrollar aplicaciones del lado del servidor. Es rápido, escalable y utiliza un modelo de entrada/salida no bloqueante.

Express

Express es un marco de trabajo minimalista para Node.js que facilita la creación de aplicaciones web y APIs robustas.

Firebase

Firebase es una plataforma de desarrollo de aplicaciones que ofrece herramientas como bases de datos en tiempo real, autenticación y funciones serverless.

---

Requisitos previos

1. Tener instalado Node.js.
2. Conocimientos básicos de JavaScript.
3. Una cuenta en Firebase.
4. Un editor de código, preferiblemente Visual Studio Code.

---

El desarrollo de APIs (Application Programming Interfaces) se ha convertido en una necesidad fundamental para aplicaciones modernas. En este tutorial, exploraremos cómo crear una API utilizando Node.js, Express y Firebase paso a paso. Este artículo está diseñado para programadores que desean aprender o perfeccionar sus habilidades en el desarrollo backend con herramientas modernas.

---

---

Paso 1: Configuración del proyecto

1. Inicializa un proyecto de Node.js:

mkdir api-node-express
cd api-node-express
npm init -y

Esto creará un archivo package.json con la configuración básica.

2. Instala las dependencias necesarias:

npm install express firebase-admin cors body-parser dotenv

3. Configura variables de entorno: Crea un archivo .env en la raíz del proyecto para almacenar claves y configuraciones sensibles:

PORT=3000
FIREBASE_PROJECT_ID=your-firebase-project-id
FIREBASE_PRIVATE_KEY=your-private-key
FIREBASE_CLIENT_EMAIL=your-client-email

---

Paso 2: Configura Express

Crea un archivo index.js en la raíz del proyecto:

require('dotenv').config();
const express = require('express');
const cors = require('cors');
const bodyParser = require('body-parser');
const firebaseAdmin = require('firebase-admin');

// Inicializa la app de Express
const app = express();

// Middleware
app.use(cors());
app.use(bodyParser.json());

// Configuración de Firebase
firebaseAdmin.initializeApp({
  credential: firebaseAdmin.credential.cert({
    projectId: process.env.FIREBASE_PROJECT_ID,
    privateKey: process.env.FIREBASE_PRIVATE_KEY.replace(/\\n/g, '\n'),
    clientEmail: process.env.FIREBASE_CLIENT_EMAIL,
  }),
});

const db = firebaseAdmin.firestore();

// Endpoint de prueba
app.get('/', (req, res) => {
  res.send('API funcionando correctamente');
});

// Levanta el servidor
const PORT = process.env.PORT || 3000;
app.listen(PORT, () => {
  console.log(`Servidor corriendo en http://localhost:${PORT}`);
});

Paso 3: Creación de endpoints

1. Obtener datos

Agrega un nuevo endpoint para obtener datos desde Firebase:

app.get('/data', async (req, res) => {
  try {
    const snapshot = await db.collection('miColeccion').get();
    const data = snapshot.docs.map(doc => ({ id: doc.id, ...doc.data() }));
    res.status(200).json(data);
  } catch (error) {
    res.status(500).send('Error al obtener datos: ' + error.message);
  }
});

2. Agregar datos

Agrega un endpoint para añadir datos a Firebase:

app.post('/data', async (req, res) => {
  try {
    const { nombre, valor } = req.body;
    const docRef = await db.collection('miColeccion').add({ nombre, valor });
    res.status(201).send(`Documento creado con ID: ${docRef.id}`);
  } catch (error) {
    res.status(500).send('Error al agregar datos: ' + error.message);
  }
});

3. Actualizar datos

app.put('/data/:id', async (req, res) => {
  try {
    const { id } = req.params;
    const { nombre, valor } = req.body;
    await db.collection('miColeccion').doc(id).update({ nombre, valor });
    res.status(200).send('Documento actualizado correctamente');
  } catch (error) {
    res.status(500).send('Error al actualizar datos: ' + error.message);
  }
});

4. Eliminar datos

app.delete('/data/:id', async (req, res) => {
  try {
    const { id } = req.params;
    await db.collection('miColeccion').doc(id).delete();
    res.status(200).send('Documento eliminado correctamente');
  } catch (error) {
    res.status(500).send('Error al eliminar datos: ' + error.message);
  }
});

Recomendaciones

1. Valida los datos de entrada: Utiliza bibliotecas como Joi para asegurar que los datos enviados por el cliente son válidos.
2. Maneja errores globalmente: Implementa un middleware para gestionar errores y evitar redundancia en el código.
3. Usa autenticación: Protege tus endpoints con autenticación utilizando Firebase Authentication o JWT.
4. Documenta tu API: Usa herramientas como Swagger para documentar tus endpoints.

---

Con esta guía, has creado una API básica pero funcional utilizando Node.js, Express y Firebase. Este es solo el comienzo: con estas herramientas, puedes desarrollar aplicaciones más complejas y escalables.