O que é uma janela de nonce?

Última atualização: 31 de mar. de 2025

Uma das configurações opcionais disponíveis ao gerar uma nova chave de API é uma janela de nonce.

Uma janela de nonce é um curto período de tempo (1 segundo, 10 segundos, etc.) durante o qual as solicitações de API com um nonce inválido, especificamente um valor de nonce inferior a um valor de nonce usado anteriormente, não causarão um erro de nonce inválido (EAPI:Invalid nonce).

O objetivo de uma janela de nonce é superar erros de nonce causados por inconsistência de rede (como quando as solicitações de API chegam em uma ordem diferente da ordem em que foram enviadas devido à latência da rede).

Na maioria das situações, a configuração da janela de nonce deve ser mantida em seu valor padrão de 0 (zero), mas no caso de erros de nonce inválidos serem recebidos devido a problemas de rede, a configuração da janela de nonce pode ser útil.

A configuração apropriada para uma janela de nonce depende da quantidade de tempo necessária e da resolução do próprio nonce.

Exemplos para um nonce baseado no tempo UNIX atual em milissegundos (uma escolha popular e eficaz para um nonce) seriam:

  • uma configuração de janela de nonce de 5000 permitindo uma janela de nonce de 5 segundos,

  • uma configuração de janela de nonce de 8000 permitindo uma janela de nonce de 8 segundos,

  • ou uma configuração de janela de nonce de 500 permitindo uma janela de nonce de 0,5 segundo.

Exemplos para um nonce baseado em um contador de incremento simples (1, 2, 3 e assim por diante, embora isso não seja recomendado) seriam:

  • uma configuração de janela de nonce de 30 permitindo uma janela de nonce de 10 segundos a uma taxa máxima de chamadas de API de 3 chamadas por segundo,

  • uma configuração de janela de nonce de 50 permitindo uma janela de nonce de 5 segundos a uma taxa máxima de chamadas de API de 10 chamadas por segundo,

  • ou uma configuração de janela de nonce de 5 permitindo uma janela de nonce de 5 segundos a uma taxa máxima de chamadas de API de 1 chamada por segundo.

Precisa de mais ajuda?