FAQAPI

Solicitud de número en alquiler

El método getRentNumber se utiliza para alquilar un número virtual por un periodo específico a través de la API de SMS.online. Permite automatizar el proceso de obtención de un número para recibir SMS en un país determinado y de un servicio específico. Puedes especificar los parámetros del país, el servicio y (opcionalmente) el operador para seleccionar un número disponible para uso a largo plazo.

Este método es ideal para situaciones donde se necesita un número virtual constante durante varios días, semanas o meses. Esto permite integrar el número en sistemas donde se requiere un canal estable para recibir SMS durante un periodo prolongado.

Una solicitud exitosa devuelve un objeto con información sobre el número, incluyendo su identificador, el periodo de alquiler y el costo. Este método es especialmente útil para aplicaciones y servicios con un ciclo de interacción prolongado, donde se requiere acceso constante a un solo número.

Ejemplo de solicitud:

Datos de entrada

ParámetroRequeridoNotaDescripción
SíVer en el perfil en la configuración Clave APILa clave API proporciona acceso a servicios pagados
SígetRentNumberNombre del método
SíVer lista de servicios en el menú izquierdoServicio, número para el cual se necesita obtener
SíVer lista de países en el menú izquierdoPaís, número que se necesita obtener
NoVer lista de operadores en el menú izquierdoOperador de telefonía móvil, número que se necesita obtener
No4, 8, 12, 24, 72, 168, 360, 720, 2160Tiempo de alquiler en horas
No-Enlace para webhook (por defecto no se considera)

Respuesta del servidor

JSON
{ 
  "status": "success", 
  "phone": { 
    "id": 1, 
    "endDate": "2025-05-10T12:34:56", 
    "number": "79999876543"
    } 
}

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=getRentNumber&service=${service}&country=${country}`);
# Realizamos una solicitud GET a la URL especificada
const data = await response.json();
# Mostramos el contenido de la respuesta del servidor
console.log(data);
} catch (err) {
# Si ocurrió un error, mostramos un mensaje de error
console.error(err);
}

Posibles errores

ParámetroDescripción
Acción incorrecta
Clave API incorrecta
Error en la consulta
Tiempo por el cual la cuenta está bloqueada
Cuenta inactiva
Nombre de país incorrecto
Nombre de servicio incorrecto
Hora incorrecta
Saldo no encontrado
No hay números disponibles
Cuenta bloqueada