Miete Status ändern

Die Methode setRentStatus wird verwendet, um den aktuellen Status einer gemieteten virtuellen Nummer über die API von SMS.online zu ändern. Diese Methode ermöglicht die Automatisierung der Verwaltung von Mietstatus, einschließlich der Beendigung der Nutzung, Verlängerung der Mietdauer oder Freigabe der Nummer.

Die Methode ist für Systeme gedacht, die eine zeitnahe Kontrolle des Status gemieteter Nummern in Echtzeit erfordern. Damit können Sie das Ende der Miete, Verlängerungen oder andere Statusänderungen angeben und die Aktualität der Informationen sicherstellen.

Eine erfolgreiche Anfrage gibt ein Objekt mit der Bestätigung der Statusänderung zurück, einschließlich der aktualisierten Mietparameter. Die Methode ist besonders nützlich in Diensten, die eine schnelle Aktualisierung der Informationen zur Nutzung gemieteter Nummern erfordern.

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	setRentStatus	Name der Methode
Ja	Numerischer Wert	Aktivierungs-ID, die bei der Anfrage nach der Nummer erhalten wurde
Ja	Numerischer Wert	Mietstatus

Der Status kann folgende Werte annehmen:

1 - Nutzung der Nummer beenden

2 - Kauf stornieren

Serverantwort

JSON

{ 
  "status": "success"
}

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
const status = 1; # Geben Sie den neuen Status aus der obigen Tabelle ein
try {
const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=setRentStatus&id=${id}&status=${status}`);
# 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)
	Status fehlt oder ist falsch angegeben
	Miete kann nicht storniert werden (mehr als 20 Min.)
	Miete bereits abgeschlossen
	Miete bereits storniert