A Única Maneira Correta de Retornar Dados de uma API

Vivemos numa era de excesso digital onde os desenvolvedores são ensinados a acreditar que o objetivo de uma API é servir dados. Este é um erro fundamental que custou bilhões em infraestrutura e segurança ao redor do mundo. Passamos anos debatendo REST versus GraphQL ou gRPC versus WebSockets e esquecemos de olhar para a solução mais elegante e performática que existe. Refiro-me ao conceito de No as a Service ou NaaS (https://github.com/hotheadhacker/no-as-a-service).

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:

1. “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))
2. “É só olhar o código.” (Tradução: faça engenharia reversa do nosso espaguete e boa sorte)
3. “Vamos documentar depois.” (Tradução: nunca vamos documentar)