Niveles de Límite de Frecuencia
Por ejemplo, en la tabla anterior, puedes tener 200 solicitudes GET por minuto por clave API. Cada espacio de trabajo tiene su propia clave API.
Encabezados de Límite de Frecuencia
Cada respuesta de la API incluye encabezados que muestran el estado actual de tu límite de frecuencia:Respuesta de Límite de Frecuencia Excedido
Cuando excedes el límite de frecuencia, la API devuelve una respuesta429 Too Many Requests:
Retry-After indica cuántos segundos debes esperar antes de reintentar.
Buenas Prácticas para los Límites de Frecuencia
- Monitorea los encabezados de límite de frecuencia - Revisa
X-RateLimit-Remainingpara saber cuándo te estás acercando al límite - Implementa retroceso exponencial - Al recibir errores 429, espera progresivamente más tiempo entre reintentos
- Almacena respuestas en caché - Guarda los datos de acceso frecuente para reducir las llamadas a la API
- Agrupa operaciones - Usa endpoints de actualización completa (PUT) en lugar de múltiples solicitudes PATCH
- Usa webhooks - Suscríbete a eventos en lugar de sondear los cambios de estado
- Respeta Retry-After - Espera siempre el tiempo especificado antes de reintentar