Apakah itu nonce window?

Terakhir dikemas kini: 31 Mac 2025

Salah satu tetapan pilihan yang tersedia apabila menjana API key baharu ialah nonce window.

Nonce window ialah jangka masa pendek (1 saat, 10 saat, dsb.) di mana permintaan API dengan nonce yang tidak sah, khususnya nilai nonce yang lebih rendah daripada nilai nonce yang digunakan sebelum ini, tidak akan menyebabkan ralat nonce tidak sah (EAPI:Invalid nonce).

Tujuan nonce window adalah untuk mengatasi ralat nonce yang disebabkan oleh ketidakseragaman rangkaian (seperti apabila permintaan API tiba dalam susunan yang berbeza daripada susunan ia dihantar disebabkan oleh kependaman rangkaian).

Dalam kebanyakan situasi, tetapan nonce window harus dikekalkan pada nilai lalainya 0 (sifar), tetapi sekiranya ralat nonce tidak sah diterima disebabkan oleh isu rangkaian, tetapan nonce window boleh membantu.

Tetapan yang sesuai untuk nonce window bergantung pada jumlah masa yang diperlukan dan resolusi nonce itu sendiri.

Contoh untuk nonce berdasarkan masa UNIX semasa dalam milisaat (pilihan yang popular dan berkesan untuk nonce) adalah:

  • tetapan nonce window 5000 membenarkan nonce window 5 saat,

  • tetapan nonce window 8000 membenarkan nonce window 8 saat,

  • atau tetapan nonce window 500 membenarkan nonce window 0.5 saat.

Contoh untuk nonce berdasarkan pembilang peningkatan mudah (1, 2, 3, dan seterusnya, walaupun ini tidak disyorkan) adalah:

  • tetapan nonce window 30 membenarkan nonce window 10 saat pada kadar panggilan API maksimum 3 panggilan sesaat,

  • tetapan nonce window 50 membenarkan nonce window 5 saat pada kadar panggilan API maksimum 10 panggilan sesaat,

  • atau tetapan nonce window 5 membenarkan nonce window 5 saat pada kadar panggilan API maksimum 1 panggilan sesaat.

Perlu bantuan lebih lanjut?