Límite de solicitudes
120 solicitudes por minuto por clave secreta y 60 por clave publicable y visitante, con encabezados para saber cuántas quedan.
| Clave | Límite |
|---|---|
Secreta (sk_) | 120 solicitudes por minuto por clave. |
Publicable (pk_) | 60 solicitudes por minuto por clave e IP del visitante. |
En la ruta por clave (/public/v1/posts…), toda respuesta trae:
| Encabezado | Qué es |
|---|---|
RateLimit-Limit | Solicitudes permitidas en la ventana. |
RateLimit-Remaining | Cuántas quedan todavía. |
RateLimit-Reset | Segundos hasta que la ventana vuelve a empezar. |
La ruta por sitio no envía esos encabezados, porque sus respuestas van a la caché de Cloudflare. Ahí el límite solo cuenta los fallos de caché: lo que sirve el borde no llega a Postream.
Si superas el límite, la API responde 429 con Retry-After (en segundos), en las dos rutas:
HTTP/1.1 429 Too Many Requests
Retry-After: 23
{ "statusCode": 429, "code": "RATE_LIMITED" }Cómo no llegar ahí
- Usa la ruta por sitio en el servidor: el borde de Cloudflare responde la mayor parte de las llamadas.
- Caché en el blog: con
next: { revalidate: 300 }, Next.js busca cada página como máximo cada 5 minutos, por muchas visitas que tenga. - Revalida con
ETag: un304es más liviano, pero también cuenta como solicitud. - Una clave por blog. Las claves del mismo sitio no comparten el límite: cada una tiene el suyo.
Si recibes 429, espera Retry-After segundos antes de intentar de nuevo.