Como estruturar erros de domínio vs erros de infraestrutura em APIs
Em APIs modernas, a distinção entre erros de domínio e erros de infraestrutura é essencial para construir sistemas resilientes e com boa experiência para desenvolvedores. Erros de domínio representam violações das regras de negócio — situações esperadas e previstas no fluxo da aplicação, como saldo insuficiente, CPF inválido ou produto fora de estoque. Já erros de infraestrutura são falhas técnicas imprevistas, como banco de dados offline, timeout de rede ou disco cheio.