Postream

Cargando el índice…

Documentación: Límite de solicitudes

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.

ClaveLí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:

EncabezadoQué es
RateLimit-LimitSolicitudes permitidas en la ventana.
RateLimit-RemainingCuántas quedan todavía.
RateLimit-ResetSegundos 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: un 304 es 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.