Что такое окно 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 вызов в секунду.

Нужна дополнительная помощь?