La idempotencia es la propiedad de una operación que da el mismo resultado si se ejecuta una vez o varias, de modo que repetirla no crea duplicados.
Integración · Revisado por Ray Rasouli
Pregunta sobre idempotencia
Respuestas simples, pensadas para tu caso.
Pregunta lo que quieras sobre idempotencia. Por ejemplo, cómo funciona en tus herramientas actuales.
Por ahora es una guía con guion. No guarda lo que escribes.
Las redes no son confiables. Una integración envía "crea esta factura", la conexión se cae y no queda claro si la factura se creó. Si la integración reintenta y la operación no es idempotente, ahora tienes dos facturas y un cliente molesto.
Una solución común es la clave de idempotencia: un ID único que se envía con cada petición. Si el sistema que recibe ya vio ese ID, devuelve el resultado original en lugar de repetir el trabajo.
Para un mayorista que sincroniza pedidos y pagos, la idempotencia hace que los reintentos sean seguros, y eso permite que la integración se recupere sola de las fallas.
En la práctica
Los reintentos crean registros duplicados.
Sin una clave única, cada tiempo de espera agotado arriesga un segundo pedido, pago o envío.
La clave no es realmente única.
Usar algo como una fecha o el nombre del cliente como clave hace que peticiones distintas choquen.
Las claves expiran demasiado pronto.
Algunos sistemas solo recuerdan las claves por poco tiempo, así que los reintentos tardíos pasan como peticiones nuevas.
Los receptores de webhooks no hacen la revisión.
Los emisores entregan el mismo evento más de una vez, y los receptores que no guardan los ID de evento lo procesan dos veces.
Todo lo que crea o mueve dinero o mercancía, como pedidos, pagos, reembolsos y envíos.
Por diseño, sí. Leer datos no debería cambiarlos, así que repetir un GET es seguro.
Una llamada de descubrimiento de 30 minutos con Ray y luego una lista clara de qué arreglar primero. Sin compromiso.
Con Ray Rasouli. Sin compromiso.