Limites e cotas
Cada plano tem créditos por mês e limites de requisições por minuto, por hora e por dia, contados por organização.
Lendo os planos…
Acima de um limite
Uma requisição acima de um limite de requisições recebe 429, sem custo. Aguarde os segundos do header Retry-After antes de enviá-la de novo; o corpo da resposta diz o mesmo número em retryAfter. Um limite por dia volta à meia-noite UTC.
Quando os créditos do plano no mês acabam, as extrações usam os créditos comprados; sem saldo, a resposta é 402 NOT_ENOUGH_CREDITS e nada roda.
Os headers X-RateLimit
Toda resposta da extração, depois que a chave de API é aceita, diz quantas requisições restam antes que um limite de requisições recuse uma, para o limite mais perto de recusar:
| Header | O que diz |
|---|---|
X-RateLimit-Limit | O tamanho desse limite: por minuto, por hora ou por dia. |
X-RateLimit-Remaining | As requisições que restam nele agora. |
X-RateLimit-Reset | Os segundos até X-RateLimit-Remaining subir; 0 quando nada foi contado. |
Num 429, eles dizem qual limite recusou: X-RateLimit-Remaining é 0 e X-RateLimit-Reset é igual ao Retry-After. Um navegador pode lê-los numa chamada de outro domínio.
Os headers X-Quota
Quando os créditos do plano no mês passam de 80%, as respostas 201 e 422 da extração trazem estes headers:
| Header | O que diz |
|---|---|
X-Quota-Warning | low a partir de 80% dos créditos do plano no mês; high a partir de 90%. |
X-Quota-Limit | Os créditos do plano por mês. |
X-Quota-Used | Os créditos do plano usados no mês. |
X-Quota-Remaining | Os créditos do plano que restam no mês. |
X-Quota-Percent | A parte usada, com uma casa decimal. |
Abaixo de 80%, eles não vêm. Um navegador pode lê-los numa chamada de outro domínio.