Consulta de historial de alquiler
El método getRentHistory se utiliza para obtener una lista completa de todos los números virtuales alquilados asociados a la cuenta a través de la API de SMS.online. Permite automatizar el análisis del uso de números en alquiler a largo plazo y hacer un seguimiento de los costos de renovación.
El método ofrece la posibilidad de obtener información detallada sobre el alquiler, incluyendo la fecha de inicio, la duración, el número de teléfono, el estado del alquiler y el costo de renovación. Esto permite controlar los alquileres actuales y finalizados, así como evaluar los gastos por el uso prolongado de los números.
Una solicitud exitosa devuelve un objeto estructurado con la lista de todos los números alquilados, incluyendo el identificador único del alquiler, la fecha de inicio, la duración, el número de teléfono, el estado actual y el monto del alquiler. Este método es óptimo para sistemas de análisis y monitoreo de gastos de alquiler.
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 pagos | |
| Sí | getRentHistory | Nombre del método | |
| No | Marca de tiempo en formato Unix Timestamp | Desde qué fecha tomar activaciones (limitado a 30 días) | |
| No | Marca de tiempo en formato Unix Timestamp | Hasta qué fecha tomar activaciones (limitado a 30 días) | |
| No | Valor numérico | Desplazamiento del primer elemento devuelto en la respuesta (por defecto 0) | |
| No | Valor numérico | Número de elementos devueltos en la respuesta (por defecto 50, máximo 100) |
Respuesta del servidor
[
{
"id": 635468024,
"date": "2022-11-12 15:58:39",
"phone": "79918529716",
"sms": "["Your sms code"]",
"cost": 100
"status": "4"
}
]Ejemplo de código
const api_key = "API_KEY"; # Reemplaza 'API_KEY' con tu clave API real.try {const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=getRentHistory`);# 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 ocurre un error, mostramos un mensaje de errorconsole.error(err);}Errores posibles
| Parámetro | Descripción |
|---|---|
| Acción incorrecta | |
| Clave API incorrecta | |
| Error en la consulta | |
| Tiempo por el cual la cuenta está bloqueada | |
| Cuenta no activa | |
| Fecha incorrecta |