Mês da trilha: Março 2026. Coleção publicada em 12/09/2026. Os meses organizam a trilha de leitura; não são datas de publicações anteriores.
Erros de API: um contrato para cliente e operação
A resposta pública e o diagnóstico interno têm públicos diferentes.
Conteúdo produzido com assistência de IA para o site de Thiago Silva. Análise editorial independente; não representa clientes ou empregadores.
Contexto da leitura
Leitura breve de arquitetura. A referência técnica ao final apoia o tema; os cenários hipotéticos e propostas de avaliação são análise editorial, sem relato de implementação pessoal.
Fonte original ↗A decisão de arquitetura
Quando uma falha inesperada ocorre, a equipe precisa investigar sem transformar a resposta ao usuário em um retrato da infraestrutura. O contrato de erro deve fazer parte do desenho da API.
Aplicação prática
Proposta editorial: defina categorias compreensíveis para o cliente e um identificador de correlação para a operação. Em um pagamento hipotético, diferencie rejeição de negócio de indisponibilidade, evitando sugerir uma repetição que possa duplicar a transação.
Como verificar
Simule falhas de dependência em teste e revise resposta, log e comportamento do consumidor. Verifique se alguém consegue investigar pelo identificador sem receber segredos. Uma mensagem curta só é útil quando o sistema possui o diagnóstico correspondente e um caminho de recuperação claro.