Sé idempotente y predecible donde importa

La misma llamada debe producir el mismo resultado, y los reintentos deben ser seguros, para que los agentes se recuperen sin causar efectos duplicados.

Por qué

Los agentes reintentan. A diferencia de las personas, que notan un cobro duplicado y llaman a soporte, los agentes reintentan silenciosamente una escritura fallida y crean un registro duplicado o disparan una transacción duplicada. Speakeasy identifica la predictibilidad como una propiedad fundamental de AX. El patrón de clave de idempotencia de Stripe es el estándar de la industria: el cliente genera una clave única por intención y el servidor devuelve el mismo resultado para cualquier llamada posterior con esa clave. Esto es especialmente crítico en fintech y comercio electrónico, donde los reintentos no idempotentes causan daño financiero directo.

Haz

Usa claves de idempotencia en las escrituras.

No hagas

Crear un nuevo recurso en cada reintento idéntico.

Artefacto

Envía una Idempotency-Key en las escrituras para que la misma clave devuelva el mismo resultado (reintentos seguros). Consulta el ejemplo de reembolso en AX-SYS-13.