Util::SMS - Empfangen von Codes aus SMS
Übersicht über den Parser
Dieser Parser wird nur als Plug-in-Komponente in anderen Scrapern verwendet, bei denen eine Verifizierung durch Eingabe eines SMS-Codes erforderlich sein kann, wie z. B.
SE::Yandex::Register, sowie in benutzerdefinierten JavaScript-Scrapern. Zur Bestellung von Nummern und zum Empfang von SMS-Codes werden Anbieter von virtuellen Nummern genutzt.
Das Funktionsprinzip dieses Parsers besteht darin, eine Telefonnummer anzufordern und einen Code aus einer SMS zu erhalten. Der Empfang der SMS und die Rückgabe des korrekten Codes hängen ausschließlich vom Anbieter der virtuellen Nummern ab.
Funktionen
- Unterstützung für die folgenden Anbieter virtueller Nummern: 5sim.biz, onlinesim.io, sms-activate.io
- Möglichkeit, die Wartezeit für den Code zu konfigurieren
- Möglichkeit zur Angabe einer benutzerdefinierten Konfiguration für API-Anfragen, die über die im Parser festgelegten Werte verwendet wird
Anwendungsfälle
- Abrufen von Codes aus SMS in integrierten Scrapern, bei denen eine Verifizierung durch Eingabe eines SMS-Codes erforderlich ist
- Abrufen von Codes aus SMS in eigenen JS-Scrapern
Anfragen
Bei Aufrufen aus JS-Scrapern wird empfohlen, skipProxySettingsInheritance zu aktivieren.
Es gibt 3 Arten von Anfragen, die dieser Parser entgegennimmt. Im Folgenden finden Sie Details zu jeder Anfrage.
Nummer bestellen
{"action":"getNumber"}
Als Ergebnis werden die Bestell-ID $id und die Telefonnummer $number zurückgegeben.
SMS-Code abrufen
{"action":"getCode","id":123456}
In der id muss die bei getNumber erhaltene Bestell-ID angegeben werden (im obigen Beispiel ist dies 123456). Als Ergebnis werden die Bestell-ID $id, die Telefonnummer $number (bei einigen Anbietern kann dies leer sein) und der SMS-Code $code zurückgegeben.
Bestellung schließen
{"action":"closeNumber","id":123456}
In der id muss die bei getNumber erhaltene Bestell-ID angegeben werden (im obigen Beispiel ist dies 123456).
Allgemeiner Arbeitsablauf
- Eine neue Nummer anfordern (
getNumber) - Die erhaltene Nummer dort angeben, wo sie benötigt wird
- Den SMS-Code anfordern (
getCode) unter Verwendung der Bestell-ID, die in der Antwort auf getNumber erhalten wurde - Bei erfolgreichem Erhalt des Codes diesen dort verwenden, wo er benötigt wird
- Die Bestellung schließen (
closeNumber)
Mögliche Einstellungen
| Parameter | Standardwert | Beschreibung |
|---|---|---|
| Provider | onlinesim.io | Auswahl des Anbieters für virtuelle Nummern |
| API key for provider | API-Zugriffsschlüssel für den ausgewählten Anbieter | |
| Service | Custom service | Dienst, der die SMS sendet; für Custom service muss der Dienst unbedingt in Custom config for API request gemäß der Dokumentation des gewählten Anbieters angegeben werden |
| Custom config for API request | {} | Benutzerdefinierte Konfiguration für API-Anfragen. Muss als JSON-Objekt vorliegen und nur die Parameter enthalten, die überschrieben werden sollen. Die vollständige Liste der Parameter finden Sie in der Dokumentation des gewählten Anbieters. |
| Wait time for receiving SMS | 120 | Wartezeit für den SMS-Code |