Patrones

Idempotencia

Cómo evitar cobros duplicados cuando reintentas una llamada por timeouts de red o reinicios del cliente.

Cómo funciona

En POST /v1/searches puedes pasar la cabecera Idempotency-Key con un valor único por operación lógica (recomendamos un UUID v4). Si la API recibe la misma key dos veces dentro del mismo periodo de retención, la segunda llamada devuelve la respuesta original sin volver a ejecutar y sin cobrar.

bash

# Primera llamada — ejecuta y cobra
curl -X POST https://api.tverificas.com/v1/searches \
  -H "Authorization: Bearer $TVERIFICAS_API_KEY" \
  -H "Idempotency-Key: 5f3a9b2e-4c8d-4f1a-9e2b-1d7e3f8a9c2d" \
  -H "Content-Type: application/json" \
  -d '{ "cedula": "1020487456", "endpoint": "full_check" }'

# Reintento — devuelve la misma respuesta sin cobrar
# (mismo Idempotency-Key)

Cuándo usarla

Reintentos automáticos por timeouts de red.
Webhooks que pueden disparar la misma operación más de una vez.
Reinicios del proceso cliente entre el envío y la respuesta.