Saltar al contenido principal
La API de Fintoc admite solicitudes idempotentes. Puedes reintentar una solicitud idempotente sin ejecutar la misma operación dos veces. Usa la idempotencia en solicitudes de creación de recursos que podrías reintentar después de un error de red. Algunos ejemplos son los cargos, las intenciones de pago y las transferencias. Si ocurre un error de conexión después de enviar una solicitud idempotente, puedes reintentarla sin crear un segundo objeto. Para realizar una solicitud idempotente, incluye el encabezado Idempotency-Key: <idempotency-key-value>. Una clave de idempotencia es un valor único que genera tu cliente. Fintoc usa esta clave para reconocer los reintentos de una misma solicitud. Usa UUID de versión 4 o cadenas aleatorias con suficiente entropía para evitar colisiones. Las claves de idempotencia pueden contener hasta 255 caracteres. Fintoc guarda el código de estado y el cuerpo de la respuesta de la primera solicitud para cada clave de idempotencia, tanto si la solicitud tiene éxito como si falla. Las solicitudes posteriores con la misma clave devuelven el resultado guardado, incluidos los errores 4xx y 5xx.
Autenticación necesariaFintoc no guarda un resultado idempotente cuando falla la autenticación porque la solicitud no llega al endpoint de la API.
En cada reintento, la capa de idempotencia compara los parámetros de la solicitud con los parámetros originales. Fintoc devuelve un error si los parámetros son diferentes. Fintoc puede eliminar automáticamente las claves de idempotencia cuando tienen al menos 24 horas. Si reutilizas una clave después de que Fintoc elimina el resultado original, la API procesa la solicitud como nueva. Todas las solicitudes POST aceptan claves de idempotencia. Enviar claves de idempotencia en solicitudes GET y DELETE no tiene efecto porque estas solicitudes son idempotentes por definición. Los siguientes ejemplos crean un cargo con una clave de idempotencia. Puedes reintentar la solicitud sin crear un cargo duplicado.