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 monitorear en tiempo real los alquileres activos y gestionar 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 pagos
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"; # Reemplaza 'API_KEY' con tu clave API real.
const id = 1; # Inserta 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 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
ID de alquiler no especificado