Cos'è una finestra nonce?

Ultimo aggiornamento: 31 mar 2025

Una delle impostazioni opzionali disponibili quando si genera una nuova chiave API è una finestra nonce.

Una finestra nonce è un breve intervallo di tempo (1 secondo, 10 secondi, ecc.) durante il quale le richieste API con un nonce non valido, in particolare un valore nonce inferiore a un valore nonce utilizzato in precedenza, non causeranno un errore nonce non valido (EAPI:Invalid nonce).

Lo scopo di una finestra nonce è superare gli errori nonce causati da incoerenze di rete (ad esempio, quando le richieste API arrivano in un ordine diverso rispetto all'ordine in cui sono state inviate a causa della latenza di rete).

Nella maggior parte delle situazioni, l'impostazione della finestra nonce dovrebbe essere mantenuta al suo valore predefinito di 0 (zero), ma nel caso in cui si ricevano errori nonce non validi a causa di problemi di rete, l'impostazione della finestra nonce può essere utile.

L'impostazione appropriata per una finestra nonce dipende dalla quantità di tempo richiesta e dalla risoluzione del nonce stesso.

Esempi per un nonce basato sull'ora UNIX corrente in millisecondi (una scelta popolare ed efficace per un nonce) sarebbero:

  • un'impostazione della finestra nonce di 5000 che consente una finestra nonce di 5 secondi,

  • un'impostazione della finestra nonce di 8000 che consente una finestra nonce di 8 secondi,

  • o un'impostazione della finestra nonce di 500 che consente una finestra nonce di 0,5 secondi.

Esempi per un nonce basato su un semplice contatore incrementale (1, 2, 3 e così via, sebbene questo non sia raccomandato) sarebbero:

  • un'impostazione della finestra nonce di 30 che consente una finestra nonce di 10 secondi a una velocità massima di chiamate API di 3 chiamate al secondo,

  • un'impostazione della finestra nonce di 50 che consente una finestra nonce di 5 secondi a una velocità massima di chiamate API di 10 chiamate al secondo,

  • o un'impostazione della finestra nonce di 5 che consente una finestra nonce di 5 secondi a una velocità massima di chiamate API di 1 chiamata al secondo.

Hai ancora bisogno di aiuto?