Pular para o conteúdo
Postman

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:

HeaderO que diz
X-RateLimit-LimitO tamanho desse limite: por minuto, por hora ou por dia.
X-RateLimit-RemainingAs requisições que restam nele agora.
X-RateLimit-ResetOs 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:

HeaderO que diz
X-Quota-Warninglow a partir de 80% dos créditos do plano no mês; high a partir de 90%.
X-Quota-LimitOs créditos do plano por mês.
X-Quota-UsedOs créditos do plano usados no mês.
X-Quota-RemainingOs créditos do plano que restam no mês.
X-Quota-PercentA 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.