Що таке вікно nonce?

Останнє оновлення: 31 бер. 2025 р.

Одним з необов'язкових налаштувань, доступних при генеруванні нового ключа API, є вікно nonce.

Вікно nonce — це короткий проміжок часу (1 секунда, 10 секунд тощо), протягом якого запити API з недійсним nonce, зокрема значенням nonce, меншим за раніше використане значення nonce, не призведуть до помилки недійсного nonce (EAPI:Invalid nonce).

Призначення вікна nonce полягає в подоланні помилок nonce, спричинених нестабільністю мережі (наприклад, коли запити API надходять у порядку, відмінному від порядку їх надсилання через затримку мережі).

У більшості ситуацій налаштування вікна nonce слід залишати за замовчуванням на рівні 0 (нуль), але у випадку отримання помилок недійсного nonce через проблеми з мережею, налаштування вікна nonce може бути корисним.

Відповідне налаштування для вікна nonce залежить від необхідного часу та роздільної здатності самого nonce.

Приклади nonce, заснованого на поточному часі UNIX у мілісекундах (популярний та ефективний вибір для nonce), можуть бути такими:

  • налаштування вікна nonce на 5000, що дозволяє 5-секундне вікно nonce,

  • налаштування вікна nonce на 8000, що дозволяє 8-секундне вікно nonce,

  • або налаштування вікна nonce на 500, що дозволяє 0,5-секундне вікно nonce.

Приклади nonce, заснованого на простому лічильнику, що збільшується (1, 2, 3 тощо, хоча це не рекомендується), можуть бути такими:

  • налаштування вікна nonce на 30, що дозволяє 10-секундне вікно nonce при максимальній швидкості викликів API 3 виклики на секунду,

  • налаштування вікна nonce на 50, що дозволяє 5-секундне вікно nonce при максимальній швидкості викликів API 10 викликів на секунду,

  • або налаштування вікна nonce на 5, що дозволяє 5-секундне вікно nonce при максимальній швидкості викликів API 1 виклик на секунду.

Потрібна додаткова допомога?