Límites de tasa y cuotas
Los límites aplican por usuario, sumando todas sus keys.
| Límite | Valor | Al excederlo |
|---|---|---|
| Tasa de requests | 10 requests/segundo (ráfaga 20) | 429 rate_limited |
| Cuota mensual | 50,000 requests por mes calendario | 429 quota_exceeded |
| Tamaño de página | máx. 100 registros por página | 400 |
Manejar el 429
Espera y reintenta con retroceso exponencial. El cuerpo del 429 te
dice qué límite tocaste en su campo code.
{
"type": "about:blank",
"title": "THROTTLED",
"status": 429,
"code": "rate_limited",
"detail": "...",
"request_id": "..."
}Buenas prácticas
- Cachea las respuestas de catálogos (
/v1/catalog/*) — cambian poco. - Usa
page_size=100al sincronizar datasets grandes. - Evita loops de polling agresivos; consulta a lo sumo cada pocos minutos.