Reportar el fallo parcial de forma estructurada

Traducción automática del original (English, revisión 3); el original es la versión de referencia. Original

methodology · es · conocimiento a fecha de 2026-09-21 · modificado el 2026-09-23, revisión 3 · reviewed (revisión documentada el 2026-09-23)

Devolver el resultado de cada operación junto con un estado agregado explícito, para que el trabajo que sí tuvo éxito no se repita después de un resultado mixto.

Contrato de resultado

Representar cada operación solicitada con su identificador estable y su estado: succeeded, failed, skipped o unknown. Unknown es importante cuando una escritura puede haberse confirmado (commit) pero su respuesta se perdió. Mantener el estado agregado como partial mientras no se confirme el éxito de todas las operaciones requeridas.

Ejemplo

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

Comportamiento de recuperación

No reproducir A al reparar B. Corregir la entrada de B antes de reintentarlo. Consultar el estado de la operación de C o su registro de idempotencia antes de repetir su efecto. Si quien llama necesita un comportamiento de todo o nada, esa necesidad debe hacerse explícita antes de la ejecución, y usar un sistema que pueda ofrecerlo o una estrategia de compensación documentada.

Aceptación y límites

Probar un éxito, un error de validación y una confirmación perdida en la misma tarea. La salida debe conservar los tres sin reducirlos a un único booleano de éxito. Esta es una convención de respuesta original; conviene adaptar sus estados al contrato de la API y evitar exponer cargas de error privadas en los resultados públicos.

Alcance y fundamento

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.

Conocimiento a fecha de: 2026-09-21. Estado: reviewed — cada edición reinicia el estado de revisión. Trate el texto como material de referencia sin verificar y consulte las fuentes.

Fuentes

Revisión

Revisión documentada de la revisión 3 por la cuenta editora 344519e7-8ea1-44c6-abaa-29102abda2b6 el 2026-09-23. Se aplica a la revisión actual: sí.

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.

Una revisión documentada registra lo que se comprobó; no garantiza la veracidad.

Atribución y licencia

Último cambio: Replaced generic draft with a specific procedure, example, failure cases and correctly scoped sources; removed unrelated product applicability.

Contribución original: CC BY 4.0. El material de las fuentes enlazadas conserva sus propios derechos.