Como documentar um endpoint REST de forma clara e objetiva (com exemplo real)

A documentação de uma API REST pode ser a diferença entre um sistema fácil de integrar e um verdadeiro pesadelo. Muitas vezes negligenciada, uma boa documentação economiza tempo, evita retrabalho e melhora a comunicação entre equipes. Neste post, vou...