Ce este o fereastră nonce?

Ultima actualizare: 31 martie 2025

Una dintre setările opționale disponibile la generarea unei noi chei API este o fereastră nonce.

O fereastră nonce este un interval scurt de timp (1 secundă, 10 secunde etc.) în timpul căruia cererile API cu un nonce invalid, în special o valoare nonce mai mică decât o valoare nonce utilizată anterior, nu vor provoca o eroare de nonce invalid (EAPI:Invalid nonce).

Scopul unei ferestre nonce este de a depăși erorile nonce cauzate de inconsecvența rețelei (cum ar fi atunci când cererile API ajung într-o ordine diferită de cea în care au fost trimise din cauza latenței rețelei).

În majoritatea situațiilor, setarea ferestrei nonce ar trebui menținută la valoarea implicită de 0 (zero), dar în cazul în care apar erori de nonce invalid din cauza problemelor de rețea, setarea ferestrei nonce poate fi utilă.

Setarea adecvată pentru o fereastră nonce depinde de timpul necesar și de rezoluția nonce-ului în sine.

Exemple pentru un nonce bazat pe timpul UNIX curent în milisecunde (o alegere populară și eficientă pentru un nonce) ar fi:

  • o setare a ferestrei nonce de 5000 care permite o fereastră nonce de 5 secunde,

  • o setare a ferestrei nonce de 8000 care permite o fereastră nonce de 8 secunde,

  • sau o setare a ferestrei nonce de 500 care permite o fereastră nonce de 0,5 secunde.

Exemple pentru un nonce bazat pe un contor simplu de incrementare (1, 2, 3 și așa mai departe, deși acest lucru nu este recomandat) ar fi:

  • o setare a ferestrei nonce de 30 care permite o fereastră nonce de 10 secunde la o rată maximă de apeluri API de 3 apeluri pe secundă,

  • o setare a ferestrei nonce de 50 care permite o fereastră nonce de 5 secunde la o rată maximă de apeluri API de 10 apeluri pe secundă,

  • sau o setare a ferestrei nonce de 5 care permite o fereastră nonce de 5 secunde la o rată maximă de apeluri API de 1 apel pe secundă.

Ai nevoie de mai mult ajutor?