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
| 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 | setStatus | Name der Methode | |
| Ja | Numerischer Wert | Aktivierungs-ID, die bei der Anfrage nach der Nummer erhalten wurde | |
| Ja | Numerischer Wert | Aktivierungsstatus |
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
| Serverantwort | Beschreibung |
|---|---|
| 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 habenconst status = 1; # Geben Sie den neuen Status aus der obigen Tabelle eintry {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 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ü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. |