Límites de uso
Cada llave tiene un tope por minuto y por día. Los encabezados de cada respuesta te dicen cuánto te queda.
Topes
| Ventana | Tope por llave | Cómo se cuenta |
|---|---|---|
| Minuto | 60 peticiones | Ventanas fijas de un minuto de reloj (00:00–00:59, 01:00–01:59…). |
| Día | 10.000 peticiones | Ventana fija por día UTC (de 00:00 a 23:59 UTC). |
Una petición rechazada por el tope del minuto no descuenta cuota del día. Los topes se pueden ajustar por llave a pedido (escribe a departamentoid@cdtec.cl).
Encabezados
Toda respuesta autenticada trae:
| Encabezado | Significado |
|---|---|
X-RateLimit-Limit | Tope del minuto. |
X-RateLimit-Remaining | Peticiones que te quedan en el minuto en curso. |
X-RateLimit-Limit-Day | Tope del día. |
X-RateLimit-Remaining-Day | Peticiones que te quedan en el día. |
Retry-After | Solo en 429: segundos que debes esperar antes de reintentar. |
Al superar el tope
HTTP/1.1 429 Too Many Requests
Retry-After: 23
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
{ "error": { "codigo": "demasiadas_peticiones", "mensaje": "Se superó el límite de peticiones." } }Espera los segundos de Retry-After y reintenta. No reintentes en bucle sin esperar: solo gastas cuota.
Intentos fallidos de autenticación
Tras 30 peticiones con llave inválida en 10 minutos desde una misma IP, esa IP recibe 429 en vez de 401 hasta que pase la ventana. Una llave válida nunca queda bloqueada por este freno.
Cómo usar bien la cuota
- Pide rangos grandes y pocas veces. Una consulta de lecturas por día puede cubrir 31 días; por hora, 7 días. Eso suele bastar con una llamada diaria por sector.
- Usa el máximo de filas por página (
limite=1000) antes de pedir la siguiente. - No consultes datos que no cambian en cada ciclo: campos, sectores y equipos cambian poco; guárdalos y refréscalos una vez al día.
- Sincroniza de forma incremental: guarda hasta qué
iniciollegaste y pide solo lo posterior, con un pequeño solapamiento (por ejemplo, las últimas 3 horas) porque las lecturas más recientes pueden completarse después. - Reparte en el tiempo las llamadas de muchos sectores en vez de lanzarlas todas en el mismo segundo.