API de verificación por SMS para desarrolladores: primeros pasos

Si estás probando el flujo de registro de tu aplicación o automatizando la verificación, la API te permite hacer todo lo que hace el panel sin tener que abrirlo.

Antes de empezar

Obtén tu clave en la página API de tu panel. No subas la clave a tu repositorio de código; guárdala en una variable de entorno.

Flujo básico

1. Obtén la lista de servicios y países.
2. Compra un número.
3. Consulta el estado a intervalos o usa un webhook.
4. Completa la activación cuando llegue el código; cancélala si no llega.

Cosas que debes tener en cuenta

• En los reintentos, envía una cabecera Idempotency-Key. Si repites la solicitud con la misma clave tras un error de red, no se comprará un segundo número.
• Respeta el límite de peticiones; no acortes el intervalo de consulta sin necesidad.
• Gestiona por separado en tu código las respuestas de saldo insuficiente y de sin existencias.

Si tu software usa el protocolo compatible con SMS-Activate, puedes conectarte a través de los endpoints compatibles sin cambiar tu código. Todos los detalles están en la documentación de la API.