Callbacks asíncronos: reintentos, idempotencia y evidencia

Separá aceptación de resultado

En una operación asíncrona, la respuesta inicial confirma que la solicitud fue aceptada para procesamiento. No confirma que el dato ya exista ni que la consulta haya terminado bien. La interfaz debe mostrar esa diferencia y conservar el identificador de la solicitud.

Este desacople permite procesar trabajos de distinta duración sin mantener una conexión abierta. También obliga a modelar estados explícitos: aceptado, en proceso, completado, fallido o vencido, según lo que el contrato realmente exponga.

Usá una identidad estable de punta a punta

El request ID debe viajar desde la aceptación hasta el callback, los logs y cualquier intervención operativa. No lo reemplaces por un timestamp ni por un identificador de pantalla: ambos pueden repetirse o perderse al cambiar de componente.

Para lotes, sumá además una identidad por ítem. Así podés reanudar una parte sin volver a ejecutar lo que ya quedó resuelto y explicar al usuario qué elemento necesita atención.

Diseñá reintentos que no dupliquen efectos

Un callback puede llegar más de una vez porque el emisor no sabe si el receptor alcanzó a persistir la primera entrega. El receptor debe reconocer la misma operación, almacenar el resultado una sola vez y responder de forma consistente a nuevas entregas.

La clave de idempotencia tiene que estar ligada a la identidad de negocio correcta. Si se calcula con datos mutables o con la hora actual, dos reintentos pueden parecer operaciones nuevas.

• Validar autenticidad antes de procesar.
• Persistir resultado e identidad de forma atómica.
• Responder éxito también ante un duplicado ya aplicado.
• Separar error transitorio de rechazo definitivo.

Convertí la entrega en evidencia

Una traza útil conecta la solicitud del cliente, el trabajo interno, cada intento de callback y la confirmación del receptor. No necesita almacenar datos sensibles en logs: alcanza con identidades técnicas, estados, tiempos y códigos de error seguros.

Definí alertas por cola envejecida, tasa de reintentos y destinos que rechazan entregas. La observabilidad correcta permite actuar antes de que una demora técnica se convierta en una diferencia de datos para el cliente.