Util::SMS - obtención de códigos por SMS
Descripción del extractor
Este extractor se utiliza únicamente como un componente conectable en otros extractores donde puede ser necesario pasar una verificación en forma de ingreso de un código de SMS, por ejemplo
SE::Yandex::Register, así como en extractores JavaScript personalizados. Para solicitar números y recibir códigos de SMS, se utilizan proveedores de números virtuales.
El principio de funcionamiento de este extractor consiste en solicitar un número de teléfono y recibir un código de SMS. La recepción del SMS y la devolución del código correcto dependen únicamente del proveedor de números virtuales.
Características
- Soporta el trabajo con los siguientes proveedores de números virtuales: 5sim.biz, onlinesim.io, sms-activate.io
- Posibilidad de configurar el tiempo de espera del código
- Posibilidad de especificar una configuración personalizada para las solicitudes de API, que se utilizará sobre los valores establecidos en el extractor
Variantes de uso
- Obtención de códigos de SMS en extractores integrados, en los cuales es necesario pasar una verificación mediante la introducción de un código de SMS
- Obtención de códigos de SMS en extractores JS propios
Consultas
En las llamadas desde extractores JS se recomienda incluir skipProxySettingsInheritance
Existen 3 tipos de consultas que acepta este extractor. A continuación se detalla cada una.
Pedido de número
{"action":"getNumber"}
Como resultado, se devolverán el ID del pedido $id y el número de teléfono $number
Obtención del código de SMS
{"action":"getCode","id":123456}
En id se debe indicar el ID del pedido obtenido en getNumber (en el ejemplo anterior es 123456). Como resultado, se devolverán el ID del pedido $id, el número de teléfono $number (en algunos proveedores puede estar vacío) y el código del SMS $code
Cierre del pedido
{"action":"closeNumber","id":123456}
En id se debe indicar el ID del pedido obtenido en getNumber (en el ejemplo anterior es 123456)
Algoritmo general de trabajo
- Solicitar un nuevo número (
getNumber) - Indicar el número obtenido donde sea necesario
- Solicitar el código del SMS (
getCode), utilizando el ID del pedido obtenido en la respuesta a getNumber - Tras recibir con éxito el código, utilizarlo donde sea necesario
- Cerrar el pedido (
closeNumber)
Posibles ajustes
| Parámetro | Valor por defecto | Descripción |
|---|---|---|
| Provider | onlinesim.io | Selección del proveedor de números virtuales |
| API key for provider | Clave de acceso a la API del proveedor seleccionado | |
| Service | Custom service | Servicio que enviará el SMS; para Custom service, el servicio debe especificarse obligatoriamente en Custom config for API request según la documentación del proveedor seleccionado |
| Custom config for API request | {} | Configuración personalizada para solicitudes de API. Debe ser un objeto JSON y contener solo los parámetros que se deben redefinir. La lista completa de parámetros debe buscarse en la documentación del proveedor seleccionado. |
| Wait time for receiving SMS | 120 | Tiempo de espera del código de SMS |