¿Qué es una ventana nonce?

Última actualización: 31 mar 2025

Una de las configuraciones opcionales disponibles al generar una nueva clave API es una ventana nonce.

Una ventana nonce es un período de tiempo corto (1 segundo, 10 segundos, etc.) durante el cual las solicitudes de API con un nonce no válido, específicamente un valor nonce inferior a un valor nonce utilizado anteriormente, no causarán un error de nonce no válido (EAPI:Invalid nonce).

El propósito de una ventana nonce es superar los errores de nonce causados por inconsistencias de red (como cuando las solicitudes de API llegan en un orden diferente al orden en que fueron enviadas debido a la latencia de la red).

En la mayoría de las situaciones, la configuración de la ventana nonce debe mantenerse en su valor predeterminado de 0 (cero), pero en caso de que se reciban errores de nonce no válidos debido a problemas de red, la configuración de la ventana nonce puede ser útil.

La configuración adecuada para una ventana nonce depende de la cantidad de tiempo requerida y de la resolución del propio nonce.

Ejemplos de un nonce basado en la hora UNIX actual en milisegundos (una opción popular y efectiva para un nonce) serían:

  • una configuración de ventana nonce de 5000 que permite una ventana nonce de 5 segundos,

  • una configuración de ventana nonce de 8000 que permite una ventana nonce de 8 segundos,

  • o una configuración de ventana nonce de 500 que permite una ventana nonce de 0,5 segundos.

Ejemplos de un nonce basado en un contador incremental simple (1, 2, 3, y así sucesivamente, aunque esto no se recomienda) serían:

  • una configuración de ventana nonce de 30 que permite una ventana nonce de 10 segundos a una tasa máxima de llamadas API de 3 llamadas por segundo,

  • una configuración de ventana nonce de 50 que permite una ventana nonce de 5 segundos a una tasa máxima de llamadas API de 10 llamadas por segundo,

  • o una configuración de ventana nonce de 5 que permite una ventana nonce de 5 segundos a una tasa máxima de llamadas API de 1 llamada por segundo.

¿Necesita más ayuda?