Idempotencia - Finzaria

Al crear una transacción (POST /v1/transactions), un timeout o un reintento de red podrían mandar el mismo request dos veces y duplicar el movimiento. Para evitarlo, manda un Idempotency-Key.

Cómo usarlo

Genera una clave única por operación (un UUID v4 sirve) y mándala en el header:

curl https://api.finzaria.com/v1/transactions \
  -H "Authorization: Bearer $FINZARIA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 6f9619ff-8b86-d011-b42d-00cf4fc964ff" \
  -d '{ "type": "expense", "amount": "150.50", "date": "2026-07-14", "accountId": "…" }'

import { randomUUID } from "node:crypto"

await fetch("https://api.finzaria.com/v1/transactions", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.FINZARIA_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": randomUUID(),
  },
  body: JSON.stringify({ type: "expense", amount: "150.50", date: "2026-07-14", accountId: "…" }),
})

Comportamiento

Primer request con una clave: se procesa normal y se recuerda el resultado.
Reintento con la misma clave (mismo request): devuelve el mismo resultado, sin crear un segundo movimiento.
Usa una clave nueva por cada operación distinta — reutilizarla haría que la segunda operación devuelva el resultado de la primera.

Regla práctica: genera el Idempotency-Key antes de tu bloque de reintentos y reúsalo en todos los reintentos de esa misma operación.

Paginación Rate limits

⌘I

​Cómo usarlo

​Comportamiento

Cómo usarlo

Comportamiento