Qu'est-ce qu'une fenêtre de nonce ?

Dernière mise à jour : 31 mars 2025

L'un des paramètres facultatifs disponibles lors de la génération d'une nouvelle clé API est une fenêtre de nonce.

Une fenêtre de nonce est une courte période (1 seconde, 10 secondes, etc.) pendant laquelle les requêtes API avec un nonce invalide, spécifiquement une valeur de nonce inférieure à une valeur de nonce précédemment utilisée, ne provoqueront pas d'erreur de nonce invalide (EAPI:Invalid nonce).

Le but d'une fenêtre de nonce est de surmonter les erreurs de nonce causées par une incohérence réseau (par exemple, lorsque les requêtes API arrivent dans un ordre différent de celui dans lequel elles ont été envoyées en raison de la latence du réseau).

Dans la plupart des situations, le paramètre de fenêtre de nonce doit être maintenu à sa valeur par défaut de 0 (zéro), mais dans le cas où des erreurs de nonce invalides sont reçues en raison de problèmes de réseau, le paramètre de fenêtre de nonce peut être utile.

Le réglage approprié pour une fenêtre de nonce dépend de la durée requise et de la résolution du nonce lui-même.

Des exemples pour un nonce basé sur l'heure UNIX actuelle en millisecondes (un choix populaire et efficace pour un nonce) seraient :

  • un réglage de fenêtre de nonce de 5000 permettant une fenêtre de nonce de 5 secondes,

  • un réglage de fenêtre de nonce de 8000 permettant une fenêtre de nonce de 8 secondes,

  • ou un réglage de fenêtre de nonce de 500 permettant une fenêtre de nonce de 0,5 seconde.

Des exemples pour un nonce basé sur un simple compteur incrémentiel (1, 2, 3, et ainsi de suite, bien que cela ne soit pas recommandé) seraient :

  • un réglage de fenêtre de nonce de 30 permettant une fenêtre de nonce de 10 secondes à un taux d'appel API maximal de 3 appels par seconde,

  • un réglage de fenêtre de nonce de 50 permettant une fenêtre de nonce de 5 secondes à un taux d'appel API maximal de 10 appels par seconde,

  • ou un réglage de fenêtre de nonce de 5 permettant une fenêtre de nonce de 5 secondes à un taux d'appel API maximal de 1 appel par seconde.

Besoin d’aide supplémentaire ?