Hvad er et nonce window?

Sidst opdateret: 31. marts 2025

En af de valgfri indstillinger, der er tilgængelige, når du genererer en ny API-nøgle, er et nonce window.

Et nonce window er en kort tidsramme (1 sekund, 10 sekunder osv.), hvor API-anmodninger med en ugyldig nonce, specifikt en nonce-værdi, der er lavere end en tidligere brugt nonce-værdi, ikke vil forårsage en ugyldig nonce-fejl (EAPI:Invalid nonce).

Formålet med et nonce window er at overvinde nonce-fejl forårsaget af netværksinkonsistens (f.eks. når API-anmodninger ankommer i en anden rækkefølge, end de blev sendt, på grund af netværksforsinkelse).

I de fleste situationer bør indstillingen for nonce window holdes på standardværdien 0 (nul), men i tilfælde af at der modtages ugyldige nonce-fejl på grund af netværksproblemer, kan indstillingen for nonce window være nyttig.

Den passende indstilling for et nonce window afhænger af den nødvendige tid og nonce'ens opløsning.

Eksempler på en nonce baseret på den aktuelle UNIX-tid i millisekunder (et populært og effektivt valg for en nonce) ville være:

  • en nonce window-indstilling på 5000, der tillader et 5 sekunders nonce window,

  • en nonce window-indstilling på 8000, der tillader et 8 sekunders nonce window,

  • eller en nonce window-indstilling på 500, der tillader et 0.5 sekunders nonce window.

Eksempler på en nonce baseret på en simpel tæller, der tæller op (1, 2, 3 osv., selvom dette ikke anbefales), ville være:

  • en nonce window-indstilling på 30, der tillader et 10 sekunders nonce window ved en maksimal API-kaldsrate på 3 kald pr. sekund,

  • en nonce window-indstilling på 50, der tillader et 5 sekunders nonce window ved en maksimal API-kaldsrate på 10 kald pr. sekund,

  • eller en nonce window-indstilling på 5, der tillader et 5 sekunders nonce window ved en maksimal API-kaldsrate på 1 kald pr. sekund.

Har du brug for mere hjælp?