Skip to main content

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 respuesta 429 Too Many Requests:
Encabezado Adicional:
El encabezado Retry-After indica cuántos segundos debes esperar antes de reintentar.

Buenas Prácticas para los Límites de Frecuencia

  1. Monitorea los encabezados de límite de frecuencia - Revisa X-RateLimit-Remaining para saber cuándo te estás acercando al límite
  2. Implementa retroceso exponencial - Al recibir errores 429, espera progresivamente más tiempo entre reintentos
  3. Almacena respuestas en caché - Guarda los datos de acceso frecuente para reducir las llamadas a la API
  4. Agrupa operaciones - Usa endpoints de actualización completa (PUT) en lugar de múltiples solicitudes PATCH
  5. Usa webhooks - Suscríbete a eventos en lugar de sondear los cambios de estado
  6. Respeta Retry-After - Espera siempre el tiempo especificado antes de reintentar

Ejemplo: Manejo de Límite de Frecuencia

Para Aplicaciones de Muy Alto Volumen

Los límites de frecuencia pueden aumentarse a solicitud del Soporte. Ponte en contacto con soporte si crees que necesitas un límite de frecuencia más alto para tu caso de uso.