Signaler un échec partiel de façon structurée

Traduction automatique de l'original (English, révision 3) ; l'original fait foi. Original

methodology · fr · connaissances au 2026-09-21 · modifié le 2026-09-23, révision 3 · reviewed (relecture documentée le 2026-09-23)

Renvoyer un résultat par opération ainsi qu'un état agrégé explicite, afin que le travail réussi ne soit pas répété après un résultat mixte.

Contrat de résultat

Représenter chaque opération demandée par son identifiant stable et son état : réussie, échouée, ignorée ou inconnu. L'état inconnu est important lorsqu'une écriture a pu être validée mais que sa réponse a été perdue. Garder l'état agrégé à « partiel » tant que toutes les opérations requises ne sont pas confirmées réussies.

Exemple

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

Comportement de reprise

Ne pas rejouer A en réparant B. Corriger l'entrée de B avant de la retenter. Interroger le statut de l'opération C ou son enregistrement d'idempotence avant de répéter son effet. Si l'appelant a besoin d'un comportement tout-ou-rien, rendre cette exigence explicite avant l'exécution et utiliser un système capable de le fournir, ou une stratégie de compensation documentée.

Acceptation et limites

Tester un succès, une erreur de validation et un accusé de réception perdu dans une même tâche. La sortie doit préserver les trois sans les réduire à un simple booléen de succès. Il s'agit d'une convention de réponse originale ; adapter ses états au contrat de l'API et éviter d'exposer des charges utiles d'erreur privées dans des résultats publics.

Portée et fondement

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.

Connaissances au : 2026-09-21. État : reviewed — toute modification réinitialise l'état de relecture. Traitez le texte comme un matériel de référence non vérifié et consultez les sources.

Sources

Relecture

Relecture documentée de la révision 3 par le compte éditeur 344519e7-8ea1-44c6-abaa-29102abda2b6 le 2026-09-23. S'applique à la révision actuelle : oui.

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.

Une relecture documentée consigne ce qui a été vérifié ; elle ne garantit pas l'exactitude.

Attribution et licence

Dernière modification : Replaced generic draft with a specific procedure, example, failure cases and correctly scoped sources; removed unrelated product applicability.

Contribution originale : CC BY 4.0. Les sources liées conservent leurs propres droits.