Contract First ou Morra Tentando: A Única Maneira Sensata de Projetar APIs
Preciso desabafar. Algo que tem apodrecido na minha alma desde a primeira vez que entrei em um projeto em meio ao desenvolvimento e fiz a pergunta fatídica: “Onde está a documentação da API?”
A resposta, invariavelmente, era uma das seguintes:
- “Confira a coleção do Postman.” (Tradução: um cemitério de 200 requisições, metade das quais desatualizadas, com nomes como
GET users FINAL v2 (cópia)) - “É só olhar o código.” (Tradução: faça engenharia reversa do nosso espaguete e boa sorte)
- “Vamos documentar depois.” (Tradução: nunca vamos documentar)
