O objetivo
Vamos construir, peça por peça, uma API REST completa para gerenciar um recurso: as tarefas (um to-do). Ao terminar você terá montado um serviço realista a partir de funções pequenas e testáveis, exatamente como em um projeto profissional.
O recurso: uma tarefa
Cada tarefa é um objeto simples:
{ id: 1, titulo: "Estudar Node", feita: false }
id: identificador único, numérico e incremental.titulo: texto obrigatório (fornecido pelo cliente).feita: se está concluída. As tarefas novas nascem comfeita: false.
As rotas REST
REST modela o recurso e usa o método HTTP para a ação. Para as tarefas:
| Método | Rota | Ação |
|---|---|---|
| GET | /tarefas |
listar (com filtro opcional) |
| GET | /tarefas/:id |
ver uma |
| POST | /tarefas |
criar |
| PUT | /tarefas/:id |
atualizar |
| DELETE | /tarefas/:id |
apagar |
Cada operação responde com um código de status coerente: 200 (OK),
201 (criado), 400 (entrada inválida), 401 (sem autenticação),
404 (não encontrado).