Reintentos seguros
Cuando se corta una conexión, no puedes saber si tu pedido se realizó. Así que vuelve a enviarlo: durante 7 días, la misma clave de idempotencia significa el mismo pedido, y se cobra una sola vez.
Cómo funciona
POST /orders necesita un encabezado Idempotency-Key: hasta 200 caracteres ASCII sin espacios, que tú inventas y guardas con tu propio registro del pedido. Un UUID funciona bien. Usa una clave de idempotencia nueva para cada pedido nuevo.
curl -X POST "https://api.talismanleads.io/v1/orders" \
-H "Authorization: Bearer tl_live_your_key_here" \
-H "Idempotency-Key: crm-export-2026-11-05" \
-H "Content-Type: application/json" \
-d '{"checker":"whatsapp_status_detection","entries":["+14155550142","+12125550187"]}'Qué recibes
201 y el pedido nuevo.200, el mismo pedido e Idempotent-Replay: true. No se cobra nada más, aunque el precio haya cambiado desde entonces.order_status_unknown o rate_limited.409 idempotency_conflict. No se realiza ningún pedido.insufficient_balance409 price_changed, y con una clave de idempotencia nueva se realiza el pedido al precio nuevo.Cuando no lo sabes
Cualquier respuesta que se pierda, order_status_unknown y una respuesta que no es JSON, como un 502 o un 504 de una pasarela, significan lo mismo: repite la solicitud con la misma clave de idempotencia para conocer el estado real. Nunca cobra dos veces. Nunca crees una clave de idempotencia nueva porque una solicitud agotó el tiempo de espera o falló: eso es un pedido nuevo, y se cobra.
Espera un minuto entre repeticiones. Si sigue respondiendo order_status_unknown después de unos minutos, detente y contacta con soporte indicando el request_id. No crees una clave de idempotencia nueva.
Cuánto dura una clave de idempotencia
Una clave de idempotencia se recuerda durante 7 días desde que se envió por primera vez. Después de eso, la misma clave realiza un pedido nuevo, así que reintenta en pocos días y usa una clave de idempotencia nueva para cada pedido nuevo.