Consulta de historial de activaciones
El método getHistory se utiliza para obtener el historial de todas las activaciones de números virtuales asociadas a la cuenta mediante la API de SMS.online. Permite automatizar el análisis de las activaciones realizadas y el monitoreo de los gastos en servicios.
Este método está diseñado para obtener información detallada sobre cada activación, incluyendo la fecha, el número de teléfono, los códigos SMS recibidos, el costo y el estado actual. Facilita el seguimiento del uso de los números y el control de los gastos.
Una solicitud exitosa devuelve una lista estructurada de activaciones con datos detallados: identificador único de activación, fecha de creación, número de teléfono, lista de mensajes SMS recibidos, costo (0 para activas) y estado de la activación. Este método es adecuado para sistemas de análisis y gestión de gastos en servicios.
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í | getHistory | 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=getHistory`);# 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 |