Abruf der Mietgeschichte
Die Methode getRentHistory dient dazu, eine vollständige Liste aller gemieteten virtuellen Nummern, die mit dem Konto über die API von SMS.online verbunden sind, abzurufen. Sie ermöglicht die Automatisierung der Analyse der Nutzung von Nummern in der Langzeitmiete und die Überwachung der Verlängerungskosten.
Die Methode bietet die Möglichkeit, detaillierte Informationen zur Miete zu erhalten, einschließlich Startdatum, Laufzeit, Telefonnummer, Mietstatus und Verlängerungskosten. Dies ermöglicht die Kontrolle über aktuelle und abgeschlossene Mietverhältnisse sowie die Einschätzung der Ausgaben für die langfristige Nutzung von Nummern.
Eine erfolgreiche Anfrage gibt ein strukturiertes Objekt mit einer Liste aller gemieteten Nummern zurück, einschließlich der eindeutigen Miet-ID, des Startdatums, der Laufzeit, der Telefonnummer, des aktuellen Status und des Mietbetrags. Die Methode ist optimal für Analysesysteme und die Überwachung der Mietausgaben.
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 | getRentHistory | 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=getRentHistory`);# 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 |