Util::SMS - SMSからのコード取得
スクレイパーの概要
このスクレイパーは、SMSコード入力による認証が必要な他のスクレイパー（例：
SE::Yandex::Register）や、カスタムJavaScriptスクレイパー内でのみ、プラグインコンポーネントとして使用されます。電話番号の注文やSMSコードの受信には、仮想番号プロバイダーが使用されます。
このスクレイパーの動作原理は、電話番号をリクエストし、SMSからコードを取得することに基づいています。SMSの受信と正しいコードの返却は、仮想番号プロバイダーのみに依存します。
機能
- 以下の仮想番号プロバイダーをサポート：5sim.biz, onlinesim.io, sms-activate.io
- コードの待機時間を設定可能
- スクレイパーで設定された値を上書きして使用される、APIリクエスト用のカスタム設定を指定可能
ユースケース
- SMSコード入力による認証が必要な内蔵スクレイパーでのSMSコード取得
- 自作のJSスクレイパーでのSMSコード取得
クエリ
注記
JSスクレイパーから呼び出す場合は、skipProxySettingsInheritanceを有効にすることを推奨します。
このスクレイパーが受け付けるクエリには3つの種類があります。詳細は以下の通りです。
番号の注文
{"action":"getNumber"}
結果として、注文ID $id と電話番号 $number が返されます。
SMSコードの取得
{"action":"getCode","id":123456}
idには、getNumber で取得した注文IDを指定します（上記の例では 123456）。結果として、注文ID $id、電話番号 $number（プロバイダーによっては空の場合があります）、およびSMSコード $code が返されます。
注文の終了
{"action":"closeNumber","id":123456}
idには、getNumber で取得した注文IDを指定します（上記の例では 123456）。
一般的な動作アルゴリズム
- 新しい番号をリクエストする (
getNumber) - 取得した番号を必要な場所に入力する
- getNumber のレスポンスで受け取った注文IDを使用して、SMSコードをリクエストする (
getCode) - コードの取得に成功したら、それを必要な場所で使用する
- 注文を終了する (
closeNumber)
設定可能な項目
| パラメーター | デフォルト値 | 説明 |
|---|---|---|
| Provider | onlinesim.io | 仮想番号プロバイダーの選択 |
| API key for provider | 選択したプロバイダーのAPIアクセスキー | |
| Service | Custom service | SMSを送信するサービス。Custom service の場合、選択したプロバイダーのドキュメントに従って Custom config for API request でサービスを必ず指定する必要があります |
| Custom config for API request | {} | APIリクエスト用のカスタム設定。JSONオブジェクト形式で、上書きが必要なパラメーターのみを含める必要があります。パラメーターの全リストは、選択したプロバイダーのドキュメントを参照してください。 |
| Wait time for receiving SMS | 120 | SMSコードの待機時間 |