Límites de uso
Cómo funciona la limitación y cómo hacer backoff.
Los límites se aplican por aplicación y por cliente, contados globalmente en toda la plataforma en vez de por servidor, así que el techo que observas es el real.
| Cabecera | Significado |
|---|---|
| X-RateLimit-Limit | El presupuesto de la ventana actual. |
| X-RateLimit-Count | Cuánto ha usado esta ventana. |
| Retry-After | En un 429: segundos a esperar antes de reintentar. |
Las cifras exactas se configuran por aplicación y se muestran en tu aplicación dentro del portal en lugar de publicarse aquí, porque no son iguales para toda integración. Los límites del sandbox son menores que los de producción: el sandbox existe para verificar corrección, no para pruebas de carga.
Haz backoff exponencial y añade jitter. Una flota de agentes reintentando a intervalo fijo se sincroniza en una estampida y convierte un límite breve en uno sostenido.