600 peticiones por minuto por clave: cinco errores de sondeo de getStatus que hacen que tu bot tope con el límite
Tu bot gestiona un par de docenas de pedidos a la vez. Ayer todo funcionaba, pero hoy algunas llamadas a getStatus reciben un rechazo. Lo habitual es que la culpa sea del bucle de sondeo. Nuestra API de números virtuales cuenta su límite de peticiones por clave: 600 por minuto. Cuenta cualquier petición hecha con esa clave, de getNumber a setStatus, así que un sondeo descuidado de getStatus se come el presupuesto de todo el bot.
Cinco errores que se comen el límite
Sondeo sin pausa. Un bucle de getStatus sin espera lanza una petición nueva en cuanto vuelve la respuesta anterior, y un solo pedido así puede agotar el presupuesto por minuto de la clave. Preguntar más a menudo no hará que el código llegue antes. Aparece cuando el servicio envía el SMS al número. Pon una pausa entre las consultas de un mismo pedido y empieza a contarla desde el momento en que llega la respuesta.
Sondeo de pedidos terminados. El bot recibió el código pero no cerró el pedido, así que el hilo de sondeo sigue preguntando por su estado. O el pedido expiró, el dinero ya volvió a tu saldo y el número se queda en la cola hasta el próximo reinicio. ¿El código sirvió? Llama a setStatus con el estado 6 (completar) y el pedido sale de la cola. ¿Necesitas otro código en el mismo número? Envía el estado 3 y sigue consultando. Después del estado 8 (cancelar), o en cuanto getStatus informe de que el pedido está cerrado, quítalo de la cola enseguida.
Reintentos sin backoff. Una petición falla por un timeout de red o es rechazada por el límite, y el bot la repite de inmediato. Cuando todos los workers hacen lo mismo, cada rechazo genera otra petición, y la clave sigue por encima del límite hasta que la carga baja sola. Reintenta con una pausa creciente, por ejemplo 1, 2, 4, 8 segundos, con un tope de medio minuto. Añade un desfase aleatorio para que los workers no se despierten todos en el mismo segundo.
Una clave para todos los entornos. El bot de producción, el entorno de pruebas y ese script «de un momento» comparten las mismas 600 peticiones por minuto. Una ejecución de pruebas consume todo el presupuesto del minuto, y los pedidos de producción dejan de recibir estados. En tu panel puedes emitir varias claves con nombre, como prod-bot, staging y local. Mostramos la cadena de la clave una sola vez y después guardamos solo su huella, así que ponla enseguida en tu almacén de secretos. De ese modo, si se filtra una clave de pruebas, puedes revocarla sin detener el bot de producción.
Un timeout que ignora la ventana de activación. Cada servicio tiene su propia ventana, ahora mismo de una hora, fijada por el catálogo. Una sola constante para todos los servicios se equivoca en los dos sentidos. Si el bot se rinde antes de tiempo y cancela el pedido, el código podría haber llegado en los minutos que quedaban. Si el bot espera más allá del plazo, sigue consultando un pedido que ya se cerró y cuyo dinero ya se devolvió automáticamente a tu saldo. Guarda un timeout para cada servicio. Ten en cuenta también que no puedes cancelar un pedido hasta un minuto después de la compra. Un bot que cancela enseguida recibirá un rechazo y empezará a reintentar la cancelación.
Cómo encajar varios workers en 600 peticiones por minuto
La forma más sencilla de calcular tu presupuesto es partir del intervalo de sondeo:
pedidos en curso × (60 / intervalo en segundos) + otras llamadas ≤ 600
Un pedido consultado cada 5 segundos cuesta 12 peticiones por minuto. Si la clave no hace otra cosa que getStatus, son 50 pedidos a la vez. Pero getNumber, setStatus, getBalance y los reintentos también cuentan, así que deja un margen para ellos, por ejemplo una quinta parte. Eso deja 480 peticiones para getStatus: 40 pedidos con un intervalo de 5 segundos u 80 con un intervalo de 10 segundos. Cuatro workers que comparten una clave se llevan 10 o 20 pedidos cada uno.
Ahora, el límite superior. El tope base es de 100 pedidos simultáneos, y tu tope real depende de la reputación de tu cuenta. Cien pedidos consultados cada 5 segundos generan 1200 llamadas a getStatus por minuto, el doble del límite de la clave. Con un intervalo de 10 segundos salen exactamente 600, sin margen para otras llamadas.
El límite se aplica por clave, no por worker, así que tus workers necesitan un limitador compartido. Lo más sencillo es llevar el sondeo a un único bucle. Una vez por intervalo, recorre los pedidos activos y reparte los resultados entre los workers. Si tus procesos corren en máquinas distintas, guarda el contador de peticiones en un almacenamiento compartido. No hace falta consultar el saldo y los precios antes de cada getNumber. Actualízalos con getBalance y getPrices de forma programada.
Localiza las claves de scripts olvidados
Abre la lista «Tus claves» en tu panel y fíjate en la fecha de «última solicitud». Una clave que nadie usa desde hace mucho suele ser un resto de un prototipo o de un antiguo entorno de pruebas. Revócala, y la cadena que sigue en esa configuración olvidada dejará de funcionar. Si la fecha es reciente pero el nombre no te dice qué se ejecuta con esa clave, localiza ese script. Tiene su propio límite de peticiones, pero el saldo es compartido, y puede comprar números con tu dinero. Revoca todo lo que no necesites y da a cada entorno activo su propia clave con un nombre claro.