Util::SMS - otrzymywanie kodów z SMS
Przegląd scrapera
Ten scraper jest używany wyłącznie jako komponent podrzędny w innych scraperach, gdzie może być konieczne przejście weryfikacji w formie wpisania kodu z SMS, na przykład 
SE::Yandex::Register, a także w niestandardowych scraperach JavaScript. Do zamawiania numerów i odbierania kodów SMS wykorzystywani są dostawcy numerów wirtualnych.
Zasada działania tego scrapera polega na żądaniu numeru telefonu i otrzymaniu kodu z SMS. Otrzymanie SMS-a i zwrócenie poprawnego kodu zależy wyłącznie od dostawcy numerów wirtualnych.
Możliwości
- Obsługiwana jest współpraca z następującymi dostawcami numerów wirtualnych: 5sim.biz, onlinesim.io, sms-activate.io
- Możliwość konfiguracji czasu oczekiwania na kod
- Możliwość określenia niestandardowej konfiguracji dla zapytań API, która zostanie użyta nad wartościami zdefiniowanymi w scraperze
Warianty wykorzystania
- Pobieranie kodów z SMS we wbudowanych scraperach, w których konieczne jest przejście weryfikacji w postaci wpisania kodu z SMS
- Pobieranie kodów z SMS we własnych scraperach JS
Zapytania
Przy wywołaniach z scraperów JS zaleca się włączenie skipProxySettingsInheritance
Istnieją 3 rodzaje zapytań, które przyjmuje ten scraper. Poniżej szczegóły dotyczące każdego z nich.
Zamówienie numeru
{"action":"getNumber"}
W rezultacie zostaną zwrócone ID zamówienia $id oraz numer telefonu $number
Pobranie kodu z SMS
{"action":"getCode","id":123456}
W id należy podać ID zamówienia otrzymane w getNumber (w powyższym przykładzie jest to 123456). W rezultacie zostaną zwrócone ID zamówienia $id, numer telefonu $number (u niektórych dostawców może być pusty) oraz kod z SMS $code
Zamknięcie zamówienia
{"action":"closeNumber","id":123456}
W id należy podać ID zamówienia otrzymane w getNumber (w powyższym przykładzie jest to 123456)
Ogólny algorytm pracy
- Poprosić o nowy numer (
getNumber) - Podać otrzymany numer tam, gdzie jest to wymagane
- Poprosić o kod z SMS (
getCode), używając ID zamówienia otrzymanego w odpowiedzi na getNumber - Po pomyślnym otrzymaniu kodu użyć go tam, gdzie jest to wymagane
- Zamknąć zamówienie (
closeNumber)
Możliwe ustawienia
| Parametr | Wartość domyślna | Opis |
|---|---|---|
| Provider | onlinesim.io | Wybór dostawcy numerów wirtualnych |
| API key for provider | Klucz dostępu do API wybranego dostawcy | |
| Service | Custom service | Usługa, która będzie wysyłać SMS; dla Custom service usługę należy obowiązkowo wskazać w Custom config for API request zgodnie z dokumentacją wybranego dostawcy |
| Custom config for API request | {} | Niestandardowa konfiguracja dla zapytań API. Musi być w formie obiektu JSON i zawierać tylko te parametry, które należy nadpisać. Pełną listę parametrów należy znaleźć w dokumentacji wybranego dostawcy. |
| Wait time for receiving SMS | 120 | Czas oczekiwania na kod z SMS |