Un des paramétrages facultatifs qui est disponible lorsque vous générez une nouvelle clé API est le "nonce window".
Un "nonce window" est une courte période (1 seconde, 10 secondes, etc.) pendant laquelle les requêtes API avec un nonce non valide, et plus particulièrement avec une valeur de nonce inférieure à une valeur précédemment utilisée, ne provoqueront pas l'erreur de nonce non valide (EAPI : Invalid nonce).
Le but de ce paramétrage est de surmonter les erreurs générées par l'inconsistence du réseau (telles que lorsque les requêtes API arrivent dans un ordre différent que lors de l'envoi ce qui peut-être causé par la latence du réseau).
Dans la plupart des situations, le paramètre "nonce window" peut être conservé à sa valeur par défaut de 0 (zéro), mais lorsque des erreurs de nonce non valides sont reçues sans raison apparente, ce paramètre peut s'avérer utile.
La valeur optimale pour le "nonce window" dépend de la durée requise et de la résolution du nonce lui-même.
Par exemple, pour un nonce basé sur le temps UNIX en millisecondes (un choix populaire et effectif pour un nonce):
- •une valeur du "nonce window" de 5000 permet un "nonce window" de 5 secondes,
- •une valeur du "nonce window" de 8000 permet un "nonce window" de 8 secondes,
- •une valeur du "nonce window" de 500 permet un "nonce window" de 0.5 secondes.
Par exemple pour un nonce basé sur un simple compteur incrémentiel (1, 2, 3, etc; même si non recommandé):
- •une valeur du "nonce window" de 30 permet un "nonce window" de 10 secondes pour un "API call rate" maximum de 3 appels par seconde,
- •une valeur du "nonce window" de 50 permet un "nonce window" de 5 secondes pour un "API call rate" maximum de 10 appels par seconde,
- •une valeur du "nonce window" de 5 permet un "nonce window" de 5 secondes pour un "API call rate" maximum de 1 appel par seconde.