Postream

Carregando o índice…

Documentação: Limite de requisições

Limite de requisições

120 requisições por minuto por chave secreta e 60 por chave publicável e visitante, com cabeçalhos para saber quanto resta.

ChaveLimite
Secreta (sk_)120 requisições por minuto por chave.
Publicável (pk_)60 requisições por minuto por chave e IP do visitante.

Na rota pela chave (/public/v1/posts…), toda resposta traz:

CabeçalhoO que é
RateLimit-LimitRequisições permitidas na janela.
RateLimit-RemainingQuantas ainda restam.
RateLimit-ResetSegundos até a janela recomeçar.

A rota por site não manda esses cabeçalhos, porque as respostas dela vão para o cache do Cloudflare. Lá o limite só conta as faltas no cache: o que a borda serve não chega ao Postream.

Passando do limite, a API responde 429 com Retry-After (em segundos), nas duas rotas:

HTTP/1.1 429 Too Many Requests
Retry-After: 23
 
{ "statusCode": 429, "code": "RATE_LIMITED" }

Como não chegar lá

  • Use a rota por site no servidor: a borda do Cloudflare responde a maior parte das chamadas.
  • Cache no blog: com next: { revalidate: 300 }, o Next.js busca cada página no máximo a cada 5 minutos, por mais visitas que ela tenha.
  • Revalide com ETag: um 304 é mais leve, mas também conta como requisição.
  • Uma chave por blog. Chaves do mesmo site não dividem o limite: cada uma tem o seu.

Se receber 429, espere Retry-After segundos antes de tentar de novo.