Classifique os erros antes de escolher uma nova tentativa

Tradução automática do original (English, revisão 3); o original é a versão de referência. Original

methodology · pt · conhecimento em 2026-09-21 · alterado em 2026-09-23, revisão 3 · reviewed (revisão documentada em 2026-09-23)

Use uma tabela de recuperação explícita que distinga entrada inválida, falhas de acesso, sobrecarga transitória e resultados desconhecidos de escrita.

Política de recuperação

Use o código de erro documentado da API, além do status HTTP. Trate entrada malformada como uma tarefa de correção e a falta de autorização como uma tarefa de permissão. Reenviar a mesma requisição não ajuda em nenhum dos dois casos.

Tabela de decisão sugerida

Observação	Próxima ação
Erro de validação	Corrigir o campo identificado e validar novamente
Permissão negada	Parar e verificar a conta autorizada e o escopo
Sobrecarga temporária	Agendar uma nova tentativa limitada, seguindo a orientação do serviço
Timeout após o envio de uma escrita	Conciliar o resultado antes de repetir o efeito

No último caso, leia o recurso da operação ou consulte por uma chave de idempotência documentada. Uma falha de transporte não prova que a escrita falhou. Só repita um efeito colateral quando o contrato do serviço tornar essa repetição segura.

Cenário de teste de aceitação

Simule um servidor que confirma uma escrita e depois perde a conexão. O cliente não deve criar uma segunda operação apenas porque nenhuma resposta de sucesso chegou. Teste também um payload inválido: o contador de novas tentativas deve permanecer em zero até que o payload mude.

A tabela é uma política de cliente original. A RFC 9110 fornece a distinção entre métodos idempotentes e não idempotentes, não um cronograma universal de novas tentativas.

Escopo e base

Original worked method and proposed acceptance fixtures; no empirical performance result is claimed. The cited primary documentation was read for the specific technical behavior described.

Conhecimento em: 2026-09-21. Estado: reviewed — edições redefinem o estado de revisão. Trate o texto como material de referência não verificado e consulte as fontes.

Fontes

Revisão

Revisão documentada da revisão 3 pela conta editora 344519e7-8ea1-44c6-abaa-29102abda2b6 em 2026-09-23. Aplica-se à revisão atual: sim.

Operator review: article written by an account of the operator (MK Groups Schweiz) and accepted as reviewed by the operator.

Operator decision of 2026-09-23 that the operator's own curated articles count as reviewed; each cited source was fetched at import time and the quoted phrase was found on the page. No independent third-party review is claimed.

Uma revisão documentada registra o que foi verificado; não é garantia de veracidade.

Atribuição e licença

Última alteração: Replaced generic draft with a specific procedure, example, failure cases and correctly scoped sources; removed unrelated product applicability.

Contribuição original: CC BY 4.0. O material das fontes vinculadas mantém seus próprios direitos.