Util::SMS - получение кодов из смс
Обзор парсера
Данный парсер используется только в качестве подключаемого компонента в других парсерах, где может быть необходимо проходить проверку в виде ввода кода из смс, например 
SE::Yandex::Register, а также в кастомных JavaScript парсерах. Для заказа номеров и получения кодов из смс используются провайдеры виртуальных номеров.
Принцип работы этого парсера заключается в запросе номера телефона и получении кода из смс. Получение смс и возврат правильного кода зависит только от провайдера виртуальных номеров.
Возможности
- Поддерживается работа со следующими провайдерами виртуальных номеров: 5sim.biz, onlinesim.io, sms-activate.io
- Возможность настраивать время ожидания кода
- Возможность указания кастомного конфига для API запросов, который будет использован поверх значений, заданных в парсере
Варианты использования
- Получение кодов из смс во встроенных парсерах, в которых необходимо проходить проверку в виде ввода кода из смс
- Получение кодов из смс в собственных JS парсерах
Запросы
При вызовах из JS парсеров рекомендуется включать skipProxySettingsInheritance
Существует 3 вида запросов, которые принимает на вход данный парсер. Ниже подробнее о каждом.
Заказ номера
{"action":"getNumber"}
В результате будут возвращены ID заказа $id и номер телефона $number
Получение кода из смс
{"action":"getCode","id":123456}
В id нужно указать ID заказа, полученный в getNumber (в примере выше это 123456). В результате будут возвращены ID заказа $id, номер телефона $number (у некоторых провайдеров может быть пустота) и код из смс $code
Закрытие заказа
{"action":"closeNumber","id":123456}
В id нужно указать ID заказа, полученный в getNumber (в примере выше это 123456)
Общий алгоритм работы
- Запросить новый номер (
getNumber) - Указать полученный номер там, где это требуется
- Запросить код из смс (
getCode), используя ID заказа, полученного в ответе на getNumber - При успешном получении кода использовать его там, где это требуется
- Закрыть заказ (
closeNumber)
Возможные настройки
| Параметр | Значение по умолчанию | Описание |
|---|---|---|
| Provider | onlinesim.io | Выбор провайдера виртуальных номеров |
| API key for provider | Ключ доступа к API выбранного провайдера | |
| Service | Custom service | Сервис, который будет отправлять смс, для Custom service сервис нужно обязательно указать в Custom config for API request согласно документации выбранного провайдера |
| Custom config for API request | {} | Кастомный конфиг для API запросов. Должен быть в виде JSON обьекта и содержать только те параметры, которые нужно переопределить. Полный перечень параметров нужно искать в документации выбранного провайдера. |
| Wait time for receiving SMS | 120 | Время ожидания кода из смс |