FAQAPI

Lista de números virtuales alquilados activos

El método getRentList se utiliza para obtener la lista actual de todos los números virtuales alquilados asociados a tu cuenta a través de la API de SMS.online. Permite rastrear en tiempo real los alquileres activos y controlar el uso de recursos.

El método devuelve información detallada sobre cada alquiler, incluyendo el ID único del alquiler, la fecha de inicio, la duración, el estado actual, el número de teléfono y el costo del alquiler. Esto facilita la gestión de los números activos y permite renovar o finalizar el alquiler a tiempo.

El método es especialmente útil para sistemas de automatización, análisis y monitoreo, donde se requiere mostrar solo los números alquilados actuales sin el historial de sesiones finalizadas.

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ígetRentListNombre del método
SíValor numéricoID de alquiler, obtenido al solicitar el número

Respuesta del servidor

JSON
{
  "status": "success", 
  "values": [
    { 
      "id": "12345", 
      "phone": "79181234567",
      "price": "100",
      "hours": "4"
    }, 
    { 
      "id": "12345", 
      "phone": "79181234568",
      "price": "100",
      "hours": "4"
    } 
  ]
}

Ejemplo de código

const api_key = "API_KEY"; # Reemplace 'API_KEY' con su clave API real.
const id = 1; # Inserte el ID de activación obtenido al solicitar el número
try {
const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=getRentList&id=${id}`);
# 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
ID de alquiler no especificado