Calculadora de limite de taxa API
Com limite de 100 chamadas por minuto, enviar 350 exige 4 janelas: três lotes de 100 e um de 50, com 60 segundos entre eles e no mínimo 180 segundos no total. Planeje importações, sincronizações ou cargas em massa sem estourar o limite do provedor. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Limite de taxa
- 100
- Requisições desejadas
- 350
- Segundos da janela
- 60
- Janelas necessárias
- 4
- Tamanho do lote
- 100
- Tamanho do último lote
- 50
- Lotes completos
- 3
APIs públicas e privadas quase sempre publicam um limite de taxa, como cem requisições por minuto ou mil por hora. Ela devolve quantas janelas você precisa, o tamanho máximo de lote que nunca ultrapassa o limite, o tamanho do lote parcial final, o atraso a inserir entre inícios de lote, o tempo mínimo de relógio se você iniciar o primeiro lote imediatamente e o equivalente máximo de requisições por segundo.
Como janelas, lotes e atraso mantêm você abaixo do limite
Um limite de taxa de R requisições por janela de comprimento W segundos significa que, em qualquer janela deslizante ou fixa de W segundos, o provedor aceitará no máximo R chamadas bem-sucedidas. Quando você precisa de D requisições no total e D é maior que R, não pode disparar tudo de uma vez. O plano seguro é enviar no máximo R requisições na primeira janela, esperar até que uma janela completa tenha decorrido, enviar as próximas R e repetir até esgotar o restante.
O número de janelas necessárias é o teto de D dividido por R. Se D for trezentos e cinquenta e R for cem, você precisa de quatro janelas: três lotes completos de cem e um lote final de cinquenta. O atraso entre inícios de lote é igual a W quando mais de uma janela é necessária, e zero quando uma única janela basta.
O tempo mínimo decorrido é então (janelas menos um) vezes W, porque o primeiro lote pode começar no instante zero e o último começa após as esperas anteriores. Este modelo coincide com as heurísticas comuns de janela fixa e token-bucket usadas em bibliotecas cliente: é deliberadamente conservador para janelas fixas e um bom primeiro orçamento para token buckets quando você não recarrega no meio da rajada.
Perguntas frequentes
Que atraso devo esperar entre lotes?
Quando uma única janela basta, o atraso é zero.
E se o limite de taxa for zero ou negativo?
Um limite de taxa não positivo não é um orçamento válido e a chamada não é cobrada.
Quantas janelas preciso para 350 chamadas com limite de 100?
Quatro. Divida 350 por 100 e arredonde para cima: três lotes completos de 100 e um último lote de 50. O último é menor, então nunca passa do limite.
Qual é o tempo mínimo para o trabalho inteiro?
O número de janelas menos uma, vezes a duração da janela. Com 4 janelas de 60 segundos, são 180 segundos, porque o primeiro lote sai na hora e só as esperas somam tempo.
A calculadora envia as chamadas por mim?
Não. Ela nunca acessa o serviço. Só dimensiona o cronograma, para que o seu próprio programa envie cada lote e espere a pausa indicada antes do próximo.
Ferramentas relacionadas
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/dev/api-rate-limit-calc \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"rate_limit":100,"desired_requests":350}'const res = await fetch("https://api.kit.forhosting.com/dev/api-rate-limit-calc", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"rate_limit": 100,
"desired_requests": 350
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/dev/api-rate-limit-calc",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"rate_limit": 100,
"desired_requests": 350
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/api-rate-limit-calc", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"rate_limit":100,"desired_requests":350}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"rate_limit":100,"desired_requests":350}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/api-rate-limit-calc", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"rate_limit": 100,
"desired_requests": 350
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "dev.api_rate_limit_calc",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |
Notas técnicas
Quem precisa enviar mais tráfego do que uma única janela permite deve dividir o trabalho em lotes e esperar entre eles para que o provedor não responda HTTP 429 nem revogue credenciais. Esta calculadora de orçamento de limite de taxa de API aceita o máximo de requisições por janela, o total de requisições que você planeja enviar e, de forma opcional, a duração da janela em segundos. Limites de taxa não positivos falham com invalid_input e não são cobrados.
Como janelas, lotes e atraso mantêm você abaixo do limite
A calculadora não chama a API remota; apenas dimensiona sua agenda para que o seu próprio cliente possa dormir entre lotes.
Contrato de entrada, campos de resposta e regras de validação
Envie por POST um corpo JSON com rate_limit, um inteiro positivo de requisições permitidas por janela; desired_requests, um inteiro não negativo de chamadas que você pretende fazer; e opcionalmente window_seconds, um comprimento finito positivo dessa janela em segundos que assume o valor sessenta quando omitido. Cada campo pode chegar como número JSON ou como string numérica. Campos ausentes, valores não finitos, desired_requests fracionário, rate_limit fracionário e qualquer rate_limit que não seja estritamente positivo falham com invalid_input e uma mensagem que nomeia o campo. Em caso de sucesso o corpo ecoa rate_limit, desired_requests e window_seconds, e devolve windows_needed, batch_size (máximo de requisições por lote completo, igual a rate_limit quando ainda há trabalho), last_batch_size (o lote parcial final, ou um lote completo quando D divide de forma exata), full_batches (quantos lotes usam o tamanho máximo antes do restante), delay_between_batches_seconds, min_elapsed_seconds, max_requests_per_second como rate_limit dividido por window_seconds, e uma string de fórmula curta que reafirma a regra do teto. Exemplo: rate_limit cem, desired_requests trezentos e cinquenta, window_seconds sessenta produz quatro janelas, lote de cem, último lote cinquenta, atraso sessenta segundos e mínimo decorrido cento e oitenta segundos. Zero desired_requests devolve zero janelas e zero atraso sem erro, o que é útil para planejadores em modo dry-run.
Onde uma calculadora de orçamento de limite de API se paga
Alimentar essa contagem mais o limite de taxa do fornecedor nesta calculadora produz uma agenda de sleep que você pode colocar em um loop de worker sem tempestades de 429 por tentativa e erro. Gestores de produto que estimam quanto tempo uma exportação em massa levará podem converter uma contagem de documentos em tempo de relógio antes de prometer ao cliente uma janela no mesmo dia. Validação falha não consome saldo. Scripts de integração que preenchem webhooks, reindexam documentos de busca ou migram tenants costumam conhecer a contagem total de itens antes de começar. Ferramentas de observabilidade e de caos podem afirmar que um gerador de carga sintética nunca ultrapassa max_requests_per_second derivado do limite publicado. Mantenha a lógica de agenda no seu cliente; use este endpoint como única fonte da verdade da aritmética para que mobile, edge workers e jobs de CI planejem da mesma forma.
Casos de integração
Migrações em massa e jobs de backfill
Divida uma contagem conhecida de requisições em lotes seguros quanto ao limite de taxa e durma delay_between_batches_seconds entre cada início de lote.
Estimativas de SLA e runbooks
Converta os limites de taxa do fornecedor em min_elapsed_seconds para que planos de plantão e ETAs ao cliente batam com o throttle real.
Tetos de teste de carga e tráfego sintético
Derive max_requests_per_second a partir de rate_limit e window_seconds antes de configurar geradores que não devem acionar proteções de produção.
Perguntas técnicas
Como calculo quantas janelas preciso para um limite de taxa de API?
Envie rate_limit (requisições inteiras positivas por janela), desired_requests (total de chamadas) e, opcionalmente, window_seconds (padrão 60). windows_needed é ceil(desired_requests / rate_limit).
A calculadora chama minha API ou dorme por mim?
Não. Ela só devolve os números da agenda. O seu cliente envia os lotes e aplica o atraso.
Quanto custa a calculadora de limite de taxa de API?
A ferramenta no navegador é gratuita. Requisições API usam saldo pré-pago KIT a US$ 0,002 por chamada bem-sucedida; entrada inválida não é cobrada.