TECNOLANDIA TECH
Publicidade

Conecte-se com o Tecnolândia Tech

BLOG + INSTAGRAM + FACEBOOK

Tecnologia na prática, em todos os formatos.

Aqui no Tecnolândia Tech, você encontra artigos e guias completos. No Instagram @djwinformatica e no Facebook TecnoInfo, acompanhe vídeos, dicas e novidades de IA, automação e tecnologia. São nossos canais oficiais.

Express.js: Crie Sua Primeira API em Node.js

Express.js: Crie Sua Primeira API em Node.js

Imagem: Pexels

Em cerca de 40 minutos você sai do zero até uma API REST completa com CRUD de tarefas, middlewares e organização em rotas — tudo com Node.js e Express, sem framework de banco de dados e sem dependência paga. O código abaixo roda em qualquer sistema operacional e é uma base real para depois plugar banco, auth e deploy.

1. Instalando o Node e criando o projeto

Instale a versão LTS do Node (inclui o npm) pelo site oficial. Depois, crie a pasta do projeto e o arquivo principal:

mkdir minha-api && cd minha-api
npm init -y
npm install express
node --version

O package.json criado pelo npm init -y já dá conta por enquanto. No final do tutorial você adiciona scripts para facilitar a vida.

2. Sua primeira rota respondendo JSON

Crie o arquivo index.js. Uma rota básica já entrega JSON com o cabeçalho correto:

const express = require('express');
const app = express();
const PORTA = 3000;

app.use(express.json());

app.get('/', (req, res) => {
  res.json({ mensagem: 'API rodando', versao: '1.0' });
});

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

Suba com node index.js e teste com o navegador ou curl http://localhost:3000. O express.json() é o middleware que faz o parse de corpo JSON — sem ele, req.body fica indefinido nos POST.

3. CRUD completo em memória

Para não depender de banco agora, guarde os dados num array. Um recurso de tarefas com quatro operações:

let tarefas = [
  { id: 1, titulo: 'Estudar Express', feita: false }
];
let proximoId = 2;

// Listar todas
app.get('/tarefas', (req, res) => res.json(tarefas));

// Buscar por id
app.get('/tarefas/:id', (req, res) => {
  const tarefa = tarefas.find(t => t.id === Number(req.params.id));
  if (!tarefa) return res.status(404).json({ erro: 'Tarefa não encontrada' });
  res.json(tarefa);
});

// Criar
app.post('/tarefas', (req, res) => {
  const { titulo } = req.body;
  if (!titulo) return res.status(400).json({ erro: 'titulo é obrigatório' });
  const nova = { id: proximoId++, titulo, feita: false };
  tarefas.push(nova);
  res.status(201).json(nova);
});

// Atualizar
app.put('/tarefas/:id', (req, res) => {
  const tarefa = tarefas.find(t => t.id === Number(req.params.id));
  if (!tarefa) return res.status(404).json({ erro: 'Tarefa não encontrada' });
  const { titulo, feita } = req.body;
  if (titulo !== undefined) tarefa.titulo = titulo;
  if (feita !== undefined) tarefa.feita = feita;
  res.json(tarefa);
});

// Deletar
app.delete('/tarefas/:id', (req, res) => {
  const indice = tarefas.findIndex(t => t.id === Number(req.params.id));
  if (indice === -1) return res.status(404).json({ erro: 'Tarefa não encontrada' });
  tarefas.splice(indice, 1);
  res.status(204).end();
});

Repare nas respostas: 201 para recurso criado, 404 quando não existe, 400 para corpo inválido e 204 sem conteúdo no delete. Usar códigos HTTP corretos é o que separa uma API amadora de uma API profissional.

4. Middleware de log e tratamento de erro

Middleware de log mostra método, rota e duração de cada requisição — essencial para depurar:

app.use((req, res, next) => {
  const inicio = Date.now();
  res.on('finish', () => {
    const duracao = Date.now() - inicio;
    console.log(`${req.method} ${req.originalUrl} - ${res.statusCode} - ${duracao}ms`);
  });
  next();
});

E um tratador de erro centralizado captura exceções sem derrubar o servidor. Ele precisa de quatro parâmetros para o Express reconhecê-lo como handler de erro:

app.use((erro, req, res, next) => {
  console.error(erro.stack);
  res.status(500).json({ erro: 'Erro interno do servidor' });
});

5. Separando as rotas com Router

Acima de umas poucas rotas, o index.js vira confusão. Extraia o arquivo rotas/tarefas.js:

const express = require('express');
const router = express.Router();

let tarefas = [];
let proximoId = 1;

router.get('/', (req, res) => res.json(tarefas));
router.post('/', (req, res) => {
  const nova = { id: proximoId++, titulo: req.body.titulo, feita: false };
  tarefas.push(nova);
  res.status(201).json(nova);
});

module.exports = router;

No index.js, monte: app.use('/tarefas', require('./rotas/tarefas')). Cada recurso do seu sistema vira um arquivo de router — quando o projeto crescer, separar por domínio mantém o código legível.

6. Validação de entrada sem framework

Antes de confiar no req.body, valide. Uma função simples já evita lixo na camada de dados:

function validarTarefa(body) {
  const erros = [];
  if (typeof body.titulo !== 'string' || body.titulo.trim().length === 0)
    erros.push('titulo é obrigatório');
  if (body.feita !== undefined && typeof body.feita !== 'boolean')
    erros.push('feita deve ser booleano');
  return erros;
}

Chame a função antes de criar ou atualizar e devolva 400 com a lista de erros. Em produção, vale migrar para uma lib de schema (Zod ou Joi), mas entender a validação manual ajuda a não virar refém da ferramenta.

7. Checklist antes de subir para produção

  • Substitua o array em memória por um banco real (Postgres, SQLite ou Mongo) — reiniciar o servidor não pode apagar dados.
  • Leia a porta de variável de ambiente (process.env.PORT) em vez de deixar 3000 fixo.
  • Adicione CORS só se um front-end em outro domínio for consumir a API.
  • Instale o nodemon no desenvolvimento (npm install -D nodemon) e use nodemon index.js.
  • Ative helmet e limite de taxa (rate limit) antes de expor a API publicamente.
  • Não devolva stack trace de erro para o cliente — logue no servidor e retorne mensagem genérica.

Recomendação prática: mantenha esse projeto de tarefas como seu template de API. A próxima vez que for integrar um front-end ou um app mobile, clone a estrutura (routers separados, validação, log, handler de erro) e troque o armazenamento — você pula a fase de gambiarra e entrega algo que outro dev consegue manter.

Publicidade