Límites de solicitudes

Ritmo de solicitudes

Los límites se aplican a cada clave de API; el plan del espacio de trabajo define las cifras. Una clave tiene un límite por segundo (una ventana deslizante de un segundo) y una cuota diaria que se reinicia a la medianoche UTC. Las sesiones del panel no tienen límite de solicitudes.

Las solicitudes rechazadas por falta de alcance o de módulo (403) no se cuentan; cualquier solicitud que pase la autenticación sí, sea cual sea su resultado.

Encabezados

Cada respuesta que pasó por el limitador incluye el margen restante. X-RateLimit-Limit y X-RateLimit-Remaining describen la ventana por segundo; el par Daily aparece cuando la clave tiene una cuota diaria.

HTTP/2 200X-RateLimit-Limit: 20X-RateLimit-Remaining: 19X-RateLimit-Daily-Limit: 100000X-RateLimit-Daily-Remaining: 98431

Cómo se ve un 429

Una solicitud limitada devuelve 429 con el código rate_limit_exceeded, el sobre de errores estándar y un encabezado Retry-After en segundos enteros. Espera al menos ese tiempo antes de reintentar; aplica backoff exponencial si vuelven a limitarte.

HTTP/2 429Content-Type: application/jsonRetry-After: 1 {"code":"rate_limit_exceeded","message":"API key rate limit exceeded.","requestId":"3f2b6c1e-…","retryable":true}

Una cuota diaria agotada responde 429 con el código daily_quota_exceeded y un Retry-After que cuenta hasta la medianoche UTC. Los encabezados de cuota no se envían en el propio 429.

Créditos

Independientemente del ritmo de solicitudes, cada lectura se cobra en créditos de la billetera del espacio de trabajo. Las lecturas en caché son baratas; una solicitud que recolecta datos nuevos cuesta más (consulta Créditos). Al llegar al tope, toda llamada con cobro, incluidas las lecturas en caché, devuelve 402 con el código credit_cap_exceeded.