什麼是 nonce window？

上次更新時間： 2025年3月31日

在產生新的 API 金鑰時，其中一個可選設定是 nonce window。

nonce window 是一個短暫的時間範圍（1 秒、10 秒等），在此期間，帶有無效 nonce（特別是低於先前使用的 nonce 值）的 API 請求不會導致無效 nonce 錯誤 (EAPI:Invalid nonce)。

nonce window 的目的是克服因網路不一致（例如 API 請求由於網路延遲而以與發送順序不同的順序到達）引起的 nonce 錯誤。

在大多數情況下，nonce window 設定應保持其預設值 0（零），但如果由於網路問題收到無效 nonce 錯誤，nonce window 設定可能會有所幫助。

nonce window 的適當設定取決於所需的時間量和 nonce 本身的解析度。

基於目前 UNIX 毫秒時間（nonce 的流行且有效的選擇）的 nonce 範例包括：

  • •

    nonce window 設定為 5000，允許 5 秒的 nonce window，

  • •

    nonce window 設定為 8000，允許 8 秒的 nonce window，

  • •

    或 nonce window 設定為 500，允許 0.5 秒的 nonce window。

基於簡單遞增計數器（1、2、3 等，儘管不建議這樣做）的 nonce 範例包括：

  • •

    nonce window 設定為 30，允許 10 秒的 nonce window，最大 API 呼叫速率為每秒 3 次呼叫，

  • •

    nonce window 設定為 50，允許 5 秒的 nonce window，最大 API 呼叫速率為每秒 10 次呼叫，

  • •

    或 nonce window 設定為 5，允許 5 秒的 nonce window，最大 API 呼叫速率為每秒 1 次呼叫。

需要更多幫助？