Abrufen der Aktivierungshistorie
Die Methode getHistory wird verwendet, um die Historie aller Aktivierungen virtueller Nummern, die mit dem Konto über die API von SMS.online verbunden sind, abzurufen. Sie ermöglicht die Automatisierung der Analyse durchgeführter Aktivierungen und die Überwachung der Ausgaben für Dienstleistungen.
Die Methode dient dazu, detaillierte Informationen zu jeder Aktivierung abzurufen, einschließlich Datum, Telefonnummer, empfangene SMS-Codes, Kosten und aktuellen Status. Dies erleichtert die Nachverfolgung der Nutzung von Nummern und die Kontrolle der Ausgaben.
Eine erfolgreiche Anfrage gibt eine strukturierte Liste der Aktivierungen mit detaillierten Daten zurück: eindeutige Aktivierungs-ID, Erstellungsdatum, Telefonnummer, Liste der empfangenen SMS-Nachrichten, Kosten (für aktive Nummern — 0) und Aktivierungsstatus. Die Methode eignet sich für Analysesysteme und das Management von Dienstleistungsausgaben.
Beispielanfrage:
Eingabedaten
| Parameter | Erforderlich | Hinweis | Beschreibung |
|---|---|---|---|
| Ja | Siehe im Profil in den Einstellungen API Schlüssel | Der API-Schlüssel gewährt Zugriff auf kostenpflichtige Dienste | |
| Ja | getHistory | Name der Methode | |
| Nein | Zeitstempel im Unix Timestamp-Format | Ab wann Aktivierungen abgerufen werden sollen (auf 30 Tage begrenzt) | |
| Nein | Zeitstempel im Unix Timestamp-Format | Bis wann Aktivierungen abgerufen werden sollen (auf 30 Tage begrenzt) | |
| Nein | Numerischer Wert | Verschiebung des ersten Elements, das in der Antwort zurückgegeben wird (Standard ist 0) | |
| Nein | Numerischer Wert | Anzahl der Elemente, die in der Antwort zurückgegeben werden (Standard ist 50, maximal 100) |
Serverantwort
[
{
"id": 635468024,
"date": "2022-11-12 15:58:39",
"phone": "79918529716",
"sms": "["Your sms code"]",
"cost": 100
"status": "4"
}
]Beispielcode
const api_key = "API_KEY"; # Ersetzen Sie 'API_KEY' durch Ihren tatsächlichen API-Schlüssel.try {const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=getHistory`);# Führen Sie eine GET-Anfrage an die angegebene URL ausconst data = await response.json();# Geben Sie den Inhalt der Serverantwort ausconsole.log(data);} catch (err) {# Wenn ein Fehler aufgetreten ist, geben Sie die Fehlermeldung ausconsole.error(err);}Mögliche Fehler
| Parameter | Beschreibung |
|---|---|
| Ungültige Aktion | |
| Ungültiger API-Schlüssel | |
| Fehler in der Anfrage | |
| Zeit, für die das Konto gesperrt ist | |
| Konto nicht aktiv | |
| Ungültiges Datum |