Saltar al contenido principal
Algunas llamadas no deben ejecutarse dos veces, como comprar un paquete de ejecuciones o borrar un dispositivo. Esas llamadas aceptan un encabezado Idempotency-Key, y sus entradas en la referencia de la API lo indican. Elige un valor único para cada cambio que quieras hacer. Un UUID funciona bien. Envía el mismo valor cuando reintentes:
Una repetición dentro de las 24 horas recibe la primera respuesta sin que el cambio vuelva a ocurrir, así que reintentar después de agotar el tiempo de espera es seguro. Enviar una clave que ya usaste en otra llamada distinta responde 422 con idempotency_key_reused.

Cómo reintentan los SDK

Los SDK reintentan un 429 después de Retry-After con todos los métodos, porque la API no ejecutó la llamada. Reintentan un 5xx o una falla de red para GET, PUT y DELETE. Un POST o PATCH solo se reintenta cuando le das una clave de idempotencia: