Errores
Todo error de la API llega comoDocondaError:
La lista completa está en errores.
Un documento que falla al procesarse no es una excepción:
create lo devuelve con status: "failed" y
doc.error. Uno cancelado tampoco: vuelve con status: "canceled". Ninguno de los dos se cobra.
Reintentos
El SDK reintenta solo los fallos de red,429 y 5xx, esperando cada vez un poco más.
Los errores de tu petición (4xx) no se reintentan: repetirlos daría lo mismo.
Nunca dos veces el mismo documento
Cada creación lleva unaIdempotency-Key: si un reintento llega después de que el primero sí funcionara, la API
devuelve el mismo documento en vez de crear (y cobrar) otro.
Si tu programa puede repetir la operación por su cuenta (un job que se reintenta, un usuario que pulsa dos
veces), pasa tu propia clave (idempotencyKey; en Python, idempotency_key), estable para esa operación: