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.
| Chave | Limite |
|---|---|
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çalho | O que é |
|---|---|
RateLimit-Limit | Requisições permitidas na janela. |
RateLimit-Remaining | Quantas ainda restam. |
RateLimit-Reset | Segundos 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: um304é 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.