Todos los artículos

Cambiaste la URL base. ¿Y ahora qué? Lista de comprobación para pasar tu bot a handler_api.php

Si tu bot ya funciona con una API al estilo de sms-activate, pasarlo a nuestro handler_api.php empieza por una sola línea de tu configuración: la URL base. Solo hay un endpoint. Las peticiones van por GET a la ruta /stubs/handler_api.php, y los nombres de los métodos son los que ya conoces. Lo delicado son los supuestos que tu integración anterior da por hechos: timeouts, frecuencia de sondeo, identificadores de país, lógica de reembolsos. Abajo tienes una lista de comprobación que recomendamos recorrer con una clave aparte mientras tu tráfico de producción sigue en la configuración antigua.

Qué métodos son los mismos

Nuestra API compatible con sms-activate cubre el ciclo principal del bot, getPrices → getNumber → getStatus → setStatus, además de las llamadas de consulta que lo acompañan:

  • getBalance: el saldo de la cuenta a la que pertenece la clave;
  • getCountries y getServicesList: las listas de países y de servicios;
  • getPrices: los precios por servicio y país;
  • getNumber: la compra de un número para un servicio;
  • getStatus: el estado de la activación y el código;
  • setStatus: 3 para pedir otro código, 6 para completar la activación, 8 para cancelar.

Si tu bot llama a otros métodos o envía otros valores a setStatus, localiza esos puntos en el código antes de hacer el cambio. Después comprueba en staging qué hace el bot con la respuesta.

Qué revisar en la lógica de tu bot

  1. Códigos de país y de servicio. No traslades a ciegas los identificadores de tu configuración antigua. Llama a getCountries y getServicesList y compara el resultado con lo que el bot tiene escrito en el código.
  2. El temporizador de espera del código. La ventana de activación se fija por servicio, ahora mismo de una hora. Con una sola constante para todos los servicios, el bot abandonará una activación antes de que termine su ventana o seguirá consultando una que ya está cerrada. Lleva un temporizador aparte para cada servicio y verifica las ventanas en staging.
  3. Cancelación. setStatus=8 no se acepta durante el primer minuto tras la compra. Si tu bot cancela un pedido enseguida cuando algo falla, añade un reintento a los 60 segundos.
  4. Presupuesto de peticiones. El límite es de 600 peticiones por minuto por clave. El bot obtiene el código consultando getStatus, y ese sondeo se come la mayor parte del límite. Treinta activaciones consultadas una vez por segundo suman 1800 peticiones por minuto, el triple del límite. Las mismas treinta consultadas una vez cada cinco segundos dan 360, lo que deja margen para getPrices y getBalance.
  5. Reembolsos. Si el código no llega antes de que termine la ventana, el dinero vuelve automáticamente. Lo mismo ocurre si cancelas antes de que llegue un código. Los reembolsos van solo al saldo interno de tu cuenta, no a una tarjeta ni a una billetera. Una vez recibido el SMS, el servicio se considera prestado y ese pedido no se reembolsa. Si llevas tu propia contabilidad del dinero por pedido, contrástala con estas reglas.
  6. Otro código. Después de setStatus=3, el bot vuelve a consultar getStatus en lugar de cerrar la activación.
  7. Moneda. Los precios y el saldo están en dólares estadounidenses. Si la configuración de tu bot tiene umbrales de precio en otra moneda, conviértelos.
  8. Pedidos simultáneos. Tu límite depende de la reputación de tu cuenta. El panel muestra tu límite actual, cuánto de él está en uso y la proporción de pedidos que recibieron código en los últimos 7 días. Un bot que acapara números «por si acaso» y luego los cancela en masa hunde esa proporción.

softId para dueños de software

Si distribuyes tu propio software, puedes conectarlo a nuestro programa de socios. Las solicitudes se revisan manualmente, por lo general en un día. Tras la aprobación recibes un software_id. Tu software lo pasa en el parámetro softId cuando compra un número, y tú, como dueño, ganas el 5% del precio de cada activación que hagan tus usuarios, sin tope. Los usuarios pagan desde sus propias cuentas y su precio no cambia. El parámetro es opcional: sin él, la API funciona exactamente igual.

Claves y una prueba en staging

En la sección «API» del panel puedes emitir varias claves con nombre. Mostramos la cadena de la clave una sola vez y guardamos solo su huella, así que pon la clave en tu almacén de secretos en cuanto la emitas. Si pierdes una clave, emite otra y revoca la antigua. El límite se cuenta por clave, así que las pruebas en staging no le quitan peticiones a tu bot de producción.

Recorre los pasos en este orden:

  1. getBalance: la clave se acepta y aparece el saldo. Para los pasos del 3 al 5 necesitas saldo suficiente para cubrir al menos dos activaciones.
  2. getPrices: hay precio para cada par «servicio + país» que necesitas.
  3. getNumber: se entrega un número y el bot ha guardado el id de activación.
  4. getStatus: el bot consulta con su frecuencia de producción y se mantiene dentro del límite.
  5. Un segundo número: cómpralo, espera un minuto y envía setStatus=8. El importe del pedido debe volver a tu saldo.

Cada clave muestra en el panel la fecha de su última solicitud. Después del cambio, eso te indica que las peticiones llegan con la clave de producción y que la clave de staging ha quedado en silencio y se puede revocar.

Empieza por la sección «API» de tu panel. Emite una clave con un nombre como «staging», ejecuta con ella getBalance → getPrices → getNumber para tus servicios y países, y solo entonces cambia la URL y la clave en tu configuración de producción.

Tu primer número en un minuto

Registrarse lleva un minuto, recargar un par más, y el código llega en 20 segundos.

Comprar número
Sin cuota mensualCancelación con reembolso en la primera hora