Node.js

Configurar o ambiente de back-end

Criar o projeto

Abra um terminal e crie uma nova pasta:

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

npm init -y cria um padrão package.json, que é onde o npm gerencia as dependências e os scripts.

Instalar dependências

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

Para que serve cada pacote:

  • express: framework web para criar nossos pontos de extremidade da API HTTP.
  • cors: permite solicitações do aplicativo do Android (de origem diferente).
  • dotenv: carrega as variáveis de ambiente a partir de um arquivo .env local.
  • @vonage/auth: ajuda a gerar/autenticar solicitações da Vonage usando JWT.
  • @vonage/verify2: o SDK do Servidor da API Verify (inicie uma verificação e, em seguida, verifique um código usando o request_id).

Por fim, certifique-se de que não cometamos o node_modules pasta ao nosso repositório do Git:

echo "node_modules" >> .gitignore

Criar o arquivo app.js

app.js será o ponto de entrada do nosso aplicativo de back-end. Esse é o arquivo que inicia um servidor HTTP e disponibiliza os endpoints que o aplicativo móvel irá chamar.

Crie o arquivo:

touch app.js

Por enquanto, vamos adicionar um servidor Express minimalista apenas para verificar se tudo está conectado corretamente.

// 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}`);
});

O que isso faz:

  • Carrega variáveis de ambiente usando dotenv
  • Cria um Expresso aplicativo
  • Permite:
    • cors para que um aplicativo móvel possa acessar essa API
    • express.json() para ler corpos de solicitação em JSON
  • Apresenta um /health ponto de extremidade para verificar rapidamente se o servidor está em funcionamento

Você pode iniciar o servidor com:

node app.js

Em seguida, abra um navegador ou execute:

curl http://localhost:3000/health

Você deve ver:

{ "status": "ok" }

Lembre-se: Esse endpoint não tem nada a ver com o Verify. É apenas uma verificação de validade antes de adicionar mais lógica.

Crie o arquivo de configuração

Vamos usar um .env arquivo para armazenar configurações e segredos, como credenciais de API.

Por enquanto, crie um arquivo vazio:

touch .env

Vamos preenchê-lo na próxima seção, assim que apresentarmos as credenciais da Vonage e explicarmos para que serve cada variável.

Por fim, certifique-se de que .env é não confirmado para que você não envie acidentalmente as credenciais. Cada desenvolvedor terá sua própria versão:

echo ".env" >> .gitignore

Estrutura de pastas atualizada

Após essa etapa, sua pasta “backend” ficará assim:

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