FAQAPI

Solicitud de número en alquiler

El método getRentNumber se utiliza para alquilar un número virtual por un período 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 el país deseado y desde el servicio indicado. Puedes especificar los parámetros del país, servicio y (opcionalmente) operador para elegir un número disponible para uso a largo plazo.

Este método es ideal para situaciones donde se necesita un número virtual constante por 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 período prolongado.

Una solicitud exitosa devuelve un objeto con información sobre el número, incluyendo su identificador, duración del alquiler y costo. Este método es especialmente útil para aplicaciones y servicios con ciclos de interacción prolongados, donde se necesita acceso constante a un mismo 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 pagos
SígetRentNumberNombre del método
SíVer la lista de servicios en el menú izquierdoServicio, número del cual se necesita obtener
SíVer la lista de países en el menú izquierdoPaís, número del cual se necesita obtener
NoVer la lista de operadores en el menú izquierdoOperador celular, número del cual 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"; # Reemplaza 'API_KEY' con tu clave API real.
const service = "SERVICE"; # Reemplaza '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; # Inserta 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 ocurre un error, mostramos un mensaje de error
console.error(err);
}

Errores posibles

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