Skip to main content
La API v1 aplica límites a todas las operaciones. No fijes una sola cuota en el código para todos los endpoints. Usa la respuesta de cada solicitud.

​
Respuestas por exceso de solicitudes

Cuando una solicitud supera un límite, la API devuelve 429:
La respuesta incluye Retry-After como un número entero de segundos. Espera al menos ese tiempo antes del siguiente intento.
No reintentes un 429 de inmediato ni ejecutes reintentos simultáneos para la misma operación.

​
Interrupciones del limitador

Si el limitador no puede tomar una decisión, la API rechaza la solicitud de forma segura con 503 y rate_limiter_unavailable. Esta respuesta no incluye Retry-After porque no indica que se haya superado una cuota. Separa los dos casos en los registros y en la lógica de reintento:
  • 429 rate_limited significa que la solicitud superó un límite.
  • 503 rate_limiter_unavailable significa que el limitador no estaba disponible.
Consulta Errores para conocer el formato compartido de los errores.