Nummer bestellen
Die Methode getNumber wird verwendet, um über die API SMS.online eine einmalige virtuelle Nummer zu erhalten. Sie ermöglicht das automatische Anfordern einer Nummer zur Verifizierung auf externen Plattformen, die eine Bestätigung per SMS erfordern. Die Methode akzeptiert Parameter für das Land, den Dienst und (optional) den Anbieter zur genauen Auswahl der Nummer.
Bei erfolgreicher Ausführung der Anfrage wird eine Zeichenkette mit einer einzigartigen Aktivierungs-ID und der Nummer zurückgegeben. Die Methode ist für die Integration in Systeme zur automatischen Registrierung und Bestätigung von Konten per SMS gedacht.
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 | getNumber | Name der Methode | |
| Ja | Siehe Liste der Dienste im linken Menü | Dienst, für den eine Nummer benötigt wird | |
| Ja | Siehe Liste der Länder im linken Menü | Land, dessen Nummer benötigt wird | |
| Nein | Siehe Liste der Betreiber im linken Menü | Mobilfunkanbieter, dessen Nummer benötigt wird | |
| Nein | Siehe im Partnerprogramm | Referenz-ID | |
| Nein | Numerischer Wert | Aktivierungstyp: 0 - SMS (Standard), 1 - nach Nummer, 2 - nach Stimme |
Serverantwort
ACCESS_NUMBER:ID:NUMBERNummer erhalten, Aktivierungs-ID - ID, die Nummer mit Ländervorwahl - NUMBER
Beispielcode
const api_key = "API_KEY"; # Ersetzen Sie 'API_KEY' durch Ihren tatsächlichen API-Schlüssel.const service = "SERVICE"; # Ersetzen Sie 'SERVICE' durch die Dienst-ID. Alle IDs können in der Dokumentation im linken Menü eingesehen werden.const country = 1; # Geben Sie die Nummer des gewünschten Landes ein. Nummern aller Länder können in der Dokumentation im linken Menü eingesehen werden.try {const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=getNumber&service=${service}&country=${country}`);# 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 | |
| Ungültiger Dienstname | |
| Ungültiger Ländername | |
| Konto gesperrt | |
| Keine verfügbaren Nummern | |
| Kein Kontostand gefunden |