Analise cabeçalhos de limite e calcule a redefinição

Este analisador recebe limite, quantidade restante, valor de redefinição e horário atual explícito; depois retorna números normalizados e os segundos inteiros até as requisições voltarem a ficar disponíveis. Ele reconhece timestamps Unix em segundos ou milissegundos, horários UTC ISO 8601 estritos e pequenos deslocamentos numéricos. Como você fornece o horário atual, a mesma entrada sempre produz o mesmo resultado.

Normalize cabeçalhos antes de agendar novas tentativas

As API normalmente informam o máximo de requisições, a quantidade restante e um valor de redefinição, mas o cliente ainda precisa transformar essas strings em uma decisão segura. Envie os valores como limit, remaining e reset e informe em current_time o instante em que a resposta chegou. O analisador confirma que limit e remaining são inteiros não negativos e rejeita uma quantidade restante maior que o limite. Ele preserva o texto original de reset, indica se interpretou o valor como timestamp absoluto ou deslocamento em segundos e fornece um horário Unix normalizado. seconds_until_reset é arredondado para cima, evitando que você tente novamente na última fração do intervalo. Se a redefinição já passou, a espera é zero, nunca negativa. A saída serve para logs, middleware de repetição, atrasos de filas e testes, sem duplicar as mesmas regras em cada integração.

Entenda a distinção entre timestamps e deslocamentos

Valores numéricos de reset seguem convenções comuns. A partir de um bilhão, o número é tratado como segundos Unix; a partir de cem bilhões, representa milissegundos Unix e é convertido. Números menores e não negativos são deslocamentos somados a current_time. Assim, 30 ou 900 funcionam como atrasos, enquanto timestamps atuais permanecem absolutos. reset também aceita um horário UTC ISO 8601 estrito, como 2026-07-25T12:01:00Z, com milissegundos opcionais. O sufixo UTC elimina suposições de fuso. current_time aceita os mesmos formatos absolutos, mas nunca é deslocamento. A validação identifica datas impossíveis, campos de horário inválidos, ausências, negativos e textos sem relação. Um reset ilegível gera erro de entrada em vez de virar zero silenciosamente, pois uma repetição imediata acidental pode agravar a limitação e prolongar uma indisponibilidade.

Use uma saída determinística em clientes e testes

Uma política de repetição deve separar análise e decisão. Use esta capacidade para estabelecer os fatos da cota e deixe seu aplicativo decidir se deve aguardar, enfileirar, reduzir concorrência ou exibir uma mensagem. current_time é fornecido de propósito: relógio do sistema, rede, localidade e aleatoriedade não alteram a resposta. Por isso, o cálculo no navegador coincide com o cálculo da API, e testes permanecem estáveis meses depois. Um deslocamento de 60 com horário atual exatamente ao meio-dia sempre gera um timestamp um minuto posterior e sessenta segundos restantes. Timestamps anteriores ao horário informado geram zero, útil para webhooks atrasados ou logs arquivados. O analisador não deduz cabeçalhos específicos nem escolhe retrocesso exponencial; ele trata os valores já extraídos. A versão no navegador é gratuita, e chamadas automatizadas usam o preço-base exibido de US$ 0,002 por item.