Co je nonce window?

Naposledy aktualizováno: 31. března 2025

Jedno z volitelných nastavení, které je k dispozici při generování nového API klíče, je nonce window.

Nonce window je krátký časový rámec (1 sekunda, 10 sekund atd.), během kterého požadavky API s neplatným nonce, konkrétně s hodnotou nonce nižší než dříve použitá hodnota nonce, nezpůsobí chybu neplatného nonce (EAPI:Invalid nonce).

Účelem nonce window je překonat chyby nonce způsobené nekonzistencí sítě (například když požadavky API dorazí v jiném pořadí, než v jakém byly odeslány, kvůli latenci sítě).

Ve většině situací by nastavení nonce window mělo zůstat na výchozí hodnotě 0 (nula), ale v případě, že jsou přijímány chyby neplatného nonce kvůli problémům se sítí, může být nastavení nonce window užitečné.

Vhodné nastavení pro nonce window závisí na požadovaném čase a rozlišení samotného nonce.

Příklady pro nonce založené na aktuálním UNIX čase v milisekundách (populární a efektivní volba pro nonce) by byly:

  • nastavení nonce window na 5000, které umožňuje 5sekundové nonce window,

  • nastavení nonce window na 8000, které umožňuje 8sekundové nonce window,

  • nebo nastavení nonce window na 500, které umožňuje 0,5sekundové nonce window.

Příklady pro nonce založené na jednoduchém inkrementálním čítači (1, 2, 3 atd., ačkoli to není doporučeno) by byly:

  • nastavení nonce window na 30, které umožňuje 10sekundové nonce window při maximální rychlosti 3 API volání za sekundu,

  • nastavení nonce window na 50, které umožňuje 5sekundové nonce window při maximální rychlosti 10 API volání za sekundu,

  • nebo nastavení nonce window na 5, které umožňuje 5sekundové nonce window při maximální rychlosti 1 API volání za sekundu.

Potřebujete další pomoc?