Czym jest okno nonce?

Ostatnia aktualizacja: 31 mar 2025

Jednym z opcjonalnych ustawień dostępnych podczas generowania nowego klucza API jest okno nonce.

Okno nonce to krótki przedział czasowy (1 sekunda, 10 sekund itp.), podczas którego żądania API z nieprawidłowym nonce, a konkretnie z wartością nonce niższą niż poprzednio użyta wartość nonce, nie spowodują błędu nieprawidłowego nonce (EAPI:Invalid nonce).

Celem okna nonce jest przezwyciężenie błędów nonce spowodowanych niespójnością sieci (np. gdy żądania API docierają w innej kolejności niż zostały wysłane z powodu opóźnień sieciowych).

W większości sytuacji ustawienie okna nonce powinno być utrzymywane na wartości domyślnej 0 (zero), ale w przypadku otrzymania błędów nieprawidłowego nonce z powodu problemów z siecią, ustawienie okna nonce może być pomocne.

Odpowiednie ustawienie dla okna nonce zależy od wymaganego czasu i rozdzielczości samego nonce.

Przykłady dla nonce opartego na bieżącym czasie UNIX w milisekundach (popularny i skuteczny wybór dla nonce) to:

  • ustawienie okna nonce na 5000, co pozwala na 5-sekundowe okno nonce,

  • ustawienie okna nonce na 8000, co pozwala na 8-sekundowe okno nonce,

  • lub ustawienie okna nonce na 500, co pozwala na 0,5-sekundowe okno nonce.

Przykłady dla nonce opartego na prostym liczniku inkrementującym (1, 2, 3 itd., choć nie jest to zalecane) to:

  • ustawienie okna nonce na 30, co pozwala na 10-sekundowe okno nonce przy maksymalnej szybkości wywołań API wynoszącej 3 wywołania na sekundę,

  • ustawienie okna nonce na 50, co pozwala na 5-sekundowe okno nonce przy maksymalnej szybkości wywołań API wynoszącej 10 wywołań na sekundę,

  • lub ustawienie okna nonce na 5, co pozwala na 5-sekundowe okno nonce przy maksymalnej szybkości wywołań API wynoszącej 1 wywołanie na sekundę.

Potrzebujesz więcej pomocy?