Mi az a nonce ablak?

Utolsó frissítés: 2025. március 31.

Az új API kulcs generálásakor elérhető opcionális beállítások egyike a nonce ablak.

A nonce ablak egy rövid időkeret (1 másodperc, 10 másodperc stb.), amely alatt az érvénytelen nonce-szal rendelkező API kérések, különösen az előzőleg használt nonce értéknél alacsonyabb nonce értékkel rendelkezők, nem okoznak érvénytelen nonce hibát (EAPI:Invalid nonce).

A nonce ablak célja, hogy kiküszöbölje a hálózati inkonzisztencia (például amikor az API kérések a hálózati késleltetés miatt más sorrendben érkeznek, mint ahogyan elküldték őket) okozta nonce hibákat.

A legtöbb esetben a nonce ablak beállítását az alapértelmezett 0 (nulla) értéken kell tartani, de ha hálózati problémák miatt érvénytelen nonce hibák lépnek fel, a nonce ablak beállítása hasznos lehet.

A nonce ablak megfelelő beállítása a szükséges időtartamtól és magának a nonce-nak a felbontásától függ.

Példák a jelenlegi UNIX idő ezredmásodpercben alapuló nonce-ra (népszerű és hatékony választás nonce-nak):

  • egy 5000-es nonce ablak beállítás, amely 5 másodperces nonce ablakot tesz lehetővé,

  • egy 8000-es nonce ablak beállítás, amely 8 másodperces nonce ablakot tesz lehetővé,

  • vagy egy 500-as nonce ablak beállítás, amely 0,5 másodperces nonce ablakot tesz lehetővé.

Példák egy egyszerűen növekvő számlálón alapuló nonce-ra (1, 2, 3 stb., bár ez nem ajánlott):

  • egy 30-as nonce ablak beállítás, amely 10 másodperces nonce ablakot tesz lehetővé, másodpercenként legfeljebb 3 API hívás mellett,

  • egy 50-es nonce ablak beállítás, amely 5 másodperces nonce ablakot tesz lehetővé, másodpercenként legfeljebb 10 API hívás mellett,

  • vagy egy 5-ös nonce ablak beállítás, amely 5 másodperces nonce ablakot tesz lehetővé, másodpercenként legfeljebb 1 API hívás mellett.

További segítségre van szükséged?