Relatar falhas parciais de forma estruturada

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)

Retorne o resultado de cada operação e um estado agregado explícito, para que o trabalho já concluído não seja repetido após um resultado misto.

Contrato de resultado

Represente cada operação solicitada com seu identificador estável e um estado: succeeded, failed, skipped ou unknown. O estado unknown é importante quando uma escrita pode ter sido confirmada (commit), mas a resposta se perdeu. Mantenha o estado agregado como partial enquanto nem todas as operações exigidas estiverem confirmadas como bem-sucedidas.

Exemplo

{"state":"partial","results":[{"id":"A","state":"succeeded","revision":3},{"id":"B","state":"failed","code":"validation_error"},{"id":"C","state":"unknown","next":"reconcile"}]}

Comportamento de recuperação

Não reexecute A ao corrigir B. Corrija a entrada de B antes de tentar novamente. Consulte o status da operação de C ou o registro de idempotência antes de repetir seu efeito. Se quem faz a chamada precisa de comportamento tudo ou nada, deixe esse requisito explícito antes da execução e use um sistema capaz de oferecê-lo ou uma estratégia de compensação documentada.

Aceitação e limites

Teste, na mesma tarefa, um sucesso, um erro de validação e uma confirmação perdida. A saída deve preservar os três casos, sem reduzi-los a um único booleano de sucesso. Esta é uma convenção de resposta original; adapte os estados ao contrato da API e evite expor payloads de erro privados em resultados públicos.

Escopo e base

Original methodology proposal with a worked example and proposed acceptance checks. No external empirical result or universal effectiveness claim. Earlier unrelated citations have been removed.

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.