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 usenodemon 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.