Aktivierungsstatus ändern

Die Methode setStatus ermöglicht die Verwaltung des Aktivierungsstatus einer virtuellen Nummer über die API von SMS.online. Sie wird verwendet, um den aktuellen Status der Nummer im System zu ändern, beispielsweise beim Abschluss der Aktivierung oder bei der Stornierung der Nutzung der Nummer.

Diese Methode ist nützlich zur Automatisierung von Prozessen, die mit der Verwaltung virtueller Nummern verbunden sind, wenn es erforderlich ist, den Aktivierungsstatus in Echtzeit schnell zu aktualisieren.

Nach einer erfolgreichen Anfrage aktualisiert das System den Status der Nummer und enthält Informationen über die erfolgreiche Aktivierung, Stornierung oder andere Vorgänge im Zusammenhang mit der Nutzung der Nummer. Dies ermöglicht es, den aktuellen Aktivierungsstatus in integrierten Systemen aufrechtzuerhalten.

Beispielanfrage:

Eingabedaten

ParameterErforderlichHinweisBeschreibung
JaSiehe im Profil in den Einstellungen API SchlüsselDer API-Schlüssel gewährt Zugriff auf kostenpflichtige Dienste
JasetStatusName der Methode
JaNumerischer WertAktivierungs-ID, die bei der Anfrage nach der Nummer erhalten wurde
JaNumerischer WertAktivierungsstatus

Welchen Status wann senden?

Sofort nach Erhalt der Nummer befindet sich die Nummer im Wartemodus für SMS.

Folgende Aktionen stehen Ihnen zur Verfügung:

8 - Aktivierung stornieren

Sofort nach Erhalt des Codes:

3 - Eine weitere SMS anfordern

6 - SMS-Code bestätigen und Aktivierung abschließen

Für die Aktivierung mit Status 3:

6 - SMS-Code bestätigen und Aktivierung abschließen

Serverantwort

ServerantwortBeschreibung
Warten auf erneute Aktivierung
Aktivierung erfolgreich abgeschlossen
Aktivierung storniert

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=setStatus&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

ParameterBeschreibung
Ungültiger API-Schlüssel
Ungültige Aktion
Fehler in der Anfrage
Zeit, für die das Konto gesperrt ist
Konto nicht aktiv
Stornierung der Nummer in den ersten 2 Minuten nicht möglich
Aktivierung nicht gefunden
Ungültiger Status
Ungültige ID oder ID ist keine Zahl.