Docs

Idempotencia

Última actualización: 2026-07-211 min de lectura

Las llamadas de red fallan. Para reintentar un POST sin hacer -ni pagar- el trabajo dos veces, envíe una clave de idempotencia: un valor único que genera por operación lógica (un UUID va bien).

curl -X POST https://developers.grem.capital/api/v1/valuation/express \
  -H "Authorization: Bearer gsk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 3f1c8a90-1e2b-4c77-9a10-2b6d0f9e4a11" \
  -d '{"propertyCategory":"apartment","totalArea":50}'

Cómo funciona

  • La primera petición con una clave dada se ejecuta con normalidad y su resultado se guarda en caché.
  • Una repetición con la misma clave devuelve el resultado original: la herramienta no se ejecuta otra vez y no se le vuelve a cobrar.
  • Si la primera petición sigue en curso, la repetición devuelve 409 (conflicto de idempotencia): espere y reintente.

Las claves se recuerdan durante 24 horas.

Use una clave nueva para cada operación distinta. Reutilizar una misma clave para peticiones realmente diferentes devolvería el primer resultado para todas ellas.

¿Le resultó útil este artículo?