Pedido de número
El método getNumber se utiliza para obtener un número virtual desechable a través de la API SMS.online. Permite solicitar automáticamente un número para verificación en plataformas externas que requieren confirmación por SMS. El método acepta parámetros de país, servicio y (opcionalmente) operador para seleccionar el número exacto.
Si la solicitud se realiza con éxito, se devuelve una cadena con un identificador único de activación y el número en sí. Este método está diseñado para integrarse en sistemas de registro automático y confirmación de cuentas a través de SMS.
Ejemplo de solicitud:
Datos de entrada
| Parámetro | Requerido | Nota | Descripción |
|---|---|---|---|
| Sí | Ver en el perfil en la configuración Clave API | La clave API proporciona acceso a servicios pagados | |
| Sí | getNumber | Nombre del método | |
| Sí | Ver lista de servicios en el menú izquierdo | Servicio, número para el cual se necesita obtener | |
| Sí | Ver lista de países en el menú izquierdo | País, número que se necesita obtener | |
| No | Ver lista de operadores en el menú izquierdo | Operador de telefonía móvil, número que se necesita obtener | |
| No | Ver en Programa de Socios | ID de referencia | |
| No | Valor numérico | Tipo de activación: 0 - sms (por defecto), 1 - por número, 2 - por voz |
Respuesta del servidor
ACCESS_NUMBER:ID:NUMBERNúmero obtenido, ID de activación - ID, número con código de país - NUMBER
Ejemplo de código
const api_key = "API_KEY"; # Reemplace 'API_KEY' con su clave API real.const service = "SERVICE"; # Reemplace 'SERVICE' con el identificador del servicio. Todos los identificadores se pueden ver en la documentación en la lista del menú izquierdo.const country = 1; # Inserte el número del país deseado. Los números de todos los países se pueden ver en la documentación en la lista del menú izquierdo.try {const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=getNumber&service=${service}&country=${country}`);# Realizamos una solicitud GET a la URL especificadaconst data = await response.json();# Mostramos el contenido de la respuesta del servidorconsole.log(data);} catch (err) {# Si ocurrió un error, mostramos un mensaje de errorconsole.error(err);}Posibles errores
| Parámetro | Descripción |
|---|---|
| Acción incorrecta | |
| Clave API incorrecta | |
| Error en la consulta | |
| Tiempo por el cual la cuenta está bloqueada | |
| Cuenta inactiva | |
| Nombre de servicio incorrecto | |
| Nombre de país incorrecto | |
| Cuenta bloqueada | |
| No hay números disponibles | |
| Saldo no encontrado |