Idempotencia y reintentos

POST /v1/estimates y POST /v1/estimates/{id}/follow-up exigen la cabecera Idempotency-Key. Usa un valor aleatorio nuevo de 1 a 64 caracteres, como un UUID, para cada petición nueva.

Cómo trata Hometown una llave

Caso	Respuesta
Una llave nueva	Hometown ejecuta la petición y guarda su respuesta 24 horas. Una respuesta 400, 402, 413, 415, validation_failed, 429 o 5xx no se guarda, así que la misma llave sirve de nuevo.
La misma llave y el mismo cuerpo	La respuesta guardada, con Idempotent-Replayed: true. No se gastan créditos otra vez.
La misma llave mientras corre la primera petición	409 idempotency_conflict. Espera y reintenta.
La misma llave con otro cuerpo	422 idempotency_key_reused.

Cuándo reintentar

• Después de un error de red o de un tiempo de espera agotado, envía la misma petición con la misma llave.
• Después de un 429 o un 503, espera los segundos de Retry-After y envíala de nuevo con la misma llave.
• Después de una respuesta que no se guarda, corrige la petición si hace falta y reutiliza la llave. Después de cualquier otro 4xx, usa una llave nueva.