Aktivierungsstatus abrufen
Die Methode getStatus ermöglicht es, den aktuellen Aktivierungsstatus einer virtuellen Nummer über die SMS.online API abzurufen. Sie wird verwendet, um den Aktivierungsstatus auf externen Plattformen automatisiert zu überprüfen, wo eine Bestätigung per SMS erforderlich ist.
Die Methode verfolgt den Aktivierungsprozess nach Erhalt der Nummer und liefert Informationen darüber, ob die Nachricht mit dem Bestätigungscode zugestellt wurde, sowie den aktuellen Status der Nummer im System.
Eine erfolgreiche Anfrage gibt eine Zeichenkette mit Informationen über den aktuellen Aktivierungsstatus, den Status der Nachricht und den Code zurück (sofern er erhalten wurde). Die Methode eignet sich gut für die Integration in Systeme, die eine zeitnahe Überwachung des Status in Echtzeit erfordern.
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 | getStatus | Name der Methode | |
| Ja | Numerischer Wert | Aktivierungs-ID, die bei der Anfrage nach der Nummer erhalten wurde |
Serverantwort
| Serverantwort | Beschreibung |
|---|---|
| Warten auf Code | |
| Warten auf erneute SMS-Zustellung | |
| Abgebrochen | |
| Erfolgreich (wo $CODE - der Aktivierungscode ist) |
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 habentry {const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=getStatus&id=${id}`);# 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 | |
| Aktivierung nicht gefunden |