Node.js

Configurar el entorno de backend

Crear el proyecto

Abre un terminal y crea una nueva carpeta:

mkdir -p vonage-verify-tutorial/backend cd vonage-verify-tutorial/backend npm init -y

npm init -y crea un valor por defecto package.jsonque es donde npm rastrea dependencias y scripts.

Instalar dependencias

npm install express cors dotenv @vonage/auth @vonage/verify2

Para qué sirve cada paquete:

  • express: marco web para desarrollar nuestros puntos finales de la API HTTP.
  • corspermite peticiones desde la aplicación Android (origen diferente).
  • dotenv: carga variables de entorno desde un archivo local .env.
  • @vonage/authayuda a generar/autenticar solicitudes de Vonage usando JWT.
  • @vonage/verify2: el SDK del servidor de la API de Verify (iniciar una verificación y, a continuación, comprobar un código utilizando el `request_id`).

Por último, asegúrate de que no cometamos el node_modules a nuestro repositorio git:

echo "node_modules" >> .gitignore

Crear el archivo app.js

app.js será el punto de entrada de nuestra aplicación de backend. Este es el archivo que inicia un servidor HTTP y pone a disposición los puntos de conexión a los que llamará la aplicación móvil.

Crea el archivo:

touch app.js

Por ahora, vamos a añadir un servidor Express mínimo sólo para verificar que todo está cableado correctamente.

// app.js
require('dotenv').config();
const express = require('express');
const cors = require('cors');

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

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

// Health check endpoint
app.get('/health', (req, res) => {
  res.json({ status: 'ok' });
});

// Start server
app.listen(port, () => {
  console.log(`Backend listening on port ${port}`);
});

Para qué sirve:

  • Carga las variables de entorno mediante dotenv
  • Crea un Express aplicación
  • Habilita:
    • cors para que una aplicación móvil pueda llamar a esta API
    • express.json() para leer los cuerpos de las solicitudes JSON
  • Expone un /health punto final para comprobar rápidamente que el servidor está en funcionamiento

Puede iniciar el servidor con:

node app.js

A continuación, abre un navegador o ejecuta:

curl http://localhost:3000/health

Deberías verlo:

{ "status": "ok" }

Recuerde: Este punto final no tiene nada que ver con Verify. Es sólo una comprobación de cordura antes de añadir más lógica.

Crea el archivo de configuración

Utilizaremos un .env archivo para almacenar la configuración y los datos confidenciales, como las credenciales de la API.

De momento, crea un archivo vacío:

touch .env

Lo completaremos en la próxima sección, una vez que presentemos las credenciales de Vonage y expliquemos para qué se utiliza cada variable.

Por último, asegúrese de que .env es no comprometido para no confirmar credenciales accidentalmente. Cada desarrollador tendrá su propia versión:

echo ".env" >> .gitignore

Estructura de carpetas actualizada

Después de este paso, su carpeta backend tendrá el siguiente aspecto:

backend/
├── app.js          # Backend entry point
├── .env            # Environment variables (ignored by git)
├── .gitignore      # Git ignore rules
├── node_modules    # Node package repository (ignored by git)
└── package.json    # Project configuration