Obtención del 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 a través de 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 de 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 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 (para activos — 0) y estado de 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 pagados | |
| 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"; # Reemplace 'API_KEY' con su 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 ocurrió un error, mostramos un mensaje de errorconsole.error(err);}Posibles errores
| Parámetro | Descripción |
|---|---|
| Acción incorrecta | |
| Clave API incorrecta | |
| Error en la consulta | |
| Tiempo por el cual la cuenta está bloqueada | |
| Cuenta inactiva | |
| Fecha incorrecta |