Mietstatus der Nummer abrufen

Die Methode getRentStatus wird verwendet, um den aktuellen Status der gemieteten virtuellen Nummer über die SMS.online API abzurufen. Sie ermöglicht die Automatisierung des Überprüfungsprozesses und das Verfolgen eingehender SMS-Codes auf der gemieteten Nummer.

Die Methode ist für Systeme gedacht, die eine regelmäßige Überwachung der gemieteten Nummer erfordern, um rechtzeitig Bestätigungscodes und andere Daten zu erhalten, die während der Mietdauer eingehen.

Eine erfolgreiche Anfrage gibt ein Objekt mit Informationen über den aktuellen Mietstatus zurück, einschließlich einer einzigartigen Miet-ID, einer Liste der empfangenen SMS-Codes und dem Ablaufdatum der Miete. Dies ermöglicht eine effektive Kontrolle der Nutzung der Nummer und den Empfang von Nachrichten in Echtzeit.

Beispielanfrage:

Eingabedaten

Erforderlich	Hinweis	Beschreibung
Ja	Siehe im Profil in den Einstellungen API Schlüssel	Der API-Schlüssel gewährt Zugriff auf kostenpflichtige Dienste
Ja	getRentStatus	Name der Methode
Ja	Numerischer Wert	Aktivierungs-ID, die bei der Anfrage nach der Nummer erhalten wurde
Nein	Numerischer Wert	Seitenzahl, ab der die Auswahl beginnt (Seitenzählung beginnt bei 0, von neu nach alt; Standard ist 0)
Nein	Numerischer Wert	Anzahl der angeforderten Seiten (Standard ist 10)

Serverantwort

JSON

{
  "status": "success", 
  "quantity": "2", 
  "values": { 
    "0": { 
      "phoneFrom": "79180230628", 
      "text": "5", 
      "service": "ot", 
      "date": "2020-01-30 14:31:58" 
    }, 
    "1": { 
      "phoneFrom": "79180230628", 
      "text": "4", 
      "service": "ot", 
      "date": "2025-05-30 14:04:16" 
    } 
  } 
}

Beispielcode

const api_key = "API_KEY"; # Ersetzen Sie 'API_KEY' durch Ihren tatsächlichen API-Schlüssel.
const id = 1; # Geben Sie die Aktivierungs-ID ein, die Sie beim Anfordern der Nummer erhalten haben
try {
const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=getRentStatus&id=${id}`);
# Führen Sie eine GET-Anfrage an die angegebene URL aus
const data = await response.json();
# Geben Sie den Inhalt der Serverantwort aus
console.log(data);
} catch (err) {
# Wenn ein Fehler aufgetreten ist, geben Sie die Fehlermeldung aus
console.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
	Miet-ID nicht angegeben
	Nummer wurde nicht von Ihnen gemietet (falsche Miet-ID)
	Miete bezahlt und abgeschlossen
	Miete storniert mit Rückerstattung
	Warten auf die erste SMS
	Nummer gesperrt, Ihnen wurden die Mittel zurückerstattet

Mietstatus der Nummer abrufen

Eingabedaten

Serverantwort

Beispielcode

Mögliche Fehler

Nummer kaufen