Límites de solicitudes y caché

Cuántas solicitudes puedes enviar, las cabeceras que te lo indican y qué guardar en caché.

120 solicitudes por minuto

Cada dirección puede enviar 120 solicitudes por minuto a la API pública. El recuento vuelve a empezar al inicio de cada minuto del reloj; RateLimit-Reset te dice cuántos segundos faltan.

Cabeceras que indican dónde estás

Cada respuesta incluye RateLimit-Limit, cuántas solicitudes permite la ventana; RateLimit-Remaining, cuántas quedan; y RateLimit-Reset, los segundos que faltan para que la ventana vuelva a empezar.

HTTP

RateLimit-Limit: 120
RateLimit-Remaining: 116
RateLimit-Reset: 20

Cuando superas el límite

Una solicitud por encima del límite responde 429 rate_limited con una cabecera Retry-After en segundos. Espera ese tiempo antes de la siguiente solicitud; enviar más mientras tanto no acorta la espera.

HTTP

HTTP/1.1 429 Too Many Requests
Retry-After: 37

{
  "statusCode": 429,
  "code": "rate_limited",
  "message": "Too many requests. Wait and try again."
}

Guarda una copia

Los datos del catálogo cambian como mucho unas pocas veces al día. Guarda las respuestas que usas y actualízalas periódicamente en lugar de volver a pedirlas para cada visitante. Algunas respuestas llevan una cabecera Cache-Control que indica cuánto tiempo siguen vigentes.