Límites de frecuencia y reintentos en las API

Los límites de frecuencia (rate limits) y los reintentos forman parte del contrato entre un cliente y una API. Un cliente debe distinguir entre éxito, errores de validación, fallos de autenticación, límites de frecuencia y errores temporales del servidor. Elegir JSON o XML no cambia la semántica de HTTP, y las direcciones IPv4/IPv6 deben guardarse íntegras, sin presuponer la longitud de una IPv4.

Cómo gestionar la respuesta

Valide Content-Type, el código de estado, los campos documentados y la cuota. Trate HTTP 429 por separado, respete Retry-After cuando se indique y utilice un backoff exponencial acotado con jitter. Tenga en cuenta la idempotencia antes de reintentar. Registre los identificadores de solicitud, el estado y la latencia, pero nunca los secretos de la API.

Cómo responder a un 429

Cuando la API devuelva 429, lea Retry-After si está presente, en lugar de esperar a ciegas un intervalo fijo. Limite el número de reintentos, añada jitter al backoff exponencial y evite repetir automáticamente operaciones que puedan crear efectos secundarios duplicados. Para hacer una solicitud real y conocer el contrato vigente, consulte la API de 2IP.