Introducción

GoPotency es un paquete de Go flexible y agnóstico al framework diseñado para manejar la idempotencia en APIs HTTP.

¿Qué es la Idempotencia?

La idempotencia asegura que realizar la misma petición múltiples veces produzca el mismo resultado que realizarla una sola vez, sin efectos secundarios adicionales. Esto es crucial para:

• Procesamiento de Pagos: Evitar cobrar dos veces a un cliente si ocurre un tiempo de espera de red.
• Creación de Recursos: Prevenir entradas duplicadas en una base de datos cuando un cliente reintenta una petición.
• Operaciones Críticas: Cualquier acción de API donde una ejecución repetida podría llevar a un estado inconsistente.

Filosofía Principal

GoPotency fue construido con tres objetivos principales en mente:

1. Simplicidad: Fácil de integrar con solo unas pocas líneas de código.
2. Flexibilidad: Funciona con cualquier framework (Gin, net/http, Echo, etc.) y cualquier backend de almacenamiento.
3. Robustez: Maneja las peticiones concurrentes de forma segura y proporciona un manejo de errores claro para casos extremos como discrepancias en las peticiones.

Cómo Funciona

Cuando llega una petición con una Idempotency-Key:

1. Deduplicación: Comprueba si ya existe una respuesta exitosa para esa clave.
2. Bloqueo: Si la petición es nueva, adquiere un bloqueo atómico para asegurar que ninguna otra instancia procese la misma clave simultáneamente.
3. Almacenamiento: Una vez terminada, guarda la respuesta (código de estado, encabezados y cuerpo).

Características Principales

• ✅ Agnóstico al Framework: Soporte nativo para Gin y net/http estándar, adaptable a cualquier otro.
• ✅ Almacenamiento Distribuido: Soporte para Redis, SQL (Postgres/SQLite) y GORM.
• ✅ Bloqueo Atómico: Previene condiciones de carrera en sistemas distribuidos.
• ✅ Hashing Automático: Puede generar claves automáticamente a partir del contenido de la petición.
• ✅ Probado y Robusto: 100% seguro para hilos con alta cobertura de tests y benchmarks.