API で Yahoo の電話認証コードを取得する

Yahoo はどこで電話番号を求めますか？

Yahoo アカウントは、メール、ニュース、ファイナンス、ファンタジースポーツを 1 つのログインでまとめて使えるもので、電話番号はその ID の中心に近い位置にあります。よく知られたフローでは、複数の場面で表示されます。

• アカウント作成: 携帯電話番号の入力が求められ、SMS で届くコードで確認します。
• サインイン: パスワードの代わりにコードやプロンプトを送るパスワードレスの方式を含みます。
• 復旧: パスワードを忘れたとき、アカウントは登録済みの電話番号にフォールバックします。
• 2 段階認証: パスワードの後に、第 2 要素としてコードを追加します。

QA チームにとって、これらの場面はそれぞれ別のテストケースです。サインアップの確認では新しい番号が 1 回だけ必要ですが、復旧や 2 段階認証の確認では、あとで同じ番号に再び届く必要があり、どの OTP Route の製品を選ぶかに影響します。

Yahoo では番号の国は重要ですか？

重要です。Yahoo は世界中で使われており、アカウントが属する市場の番号を使うと、ローカライズされた文言、地域別のサインアップ画面、番号の表記を最も忠実にテストできます。現在、Yahoo のコードは 198 か国で受信でき、アメリカ、イギリス、カナダ、インド、フィリピン、メキシコ、ブラジル、ドイツ、フランス、インドネシア、ナイジェリア、南アフリカ、オーストラリア、スペイン、台湾などが含まれます。

番号の国はテストケースに合わせてください。マニラにあるクライアントの Yahoo メールを管理する代理店はフィリピンのルートで認証すべきですし、スペイン語のオンボーディングを確認するチームは、アメリカの番号よりもメキシコやスペインの番号のほうが多くを学べます。

サービス ID yahoo の API フローはどうなっていますか？

リクエストは https://otproute.com/api/v1 に送り、開発者コンソールで発行した or_live_ の Bearer キーで認証します。アカウントには API キー 10 個と Webhook エンドポイント 5 個を持てて、1 分あたり 300 リクエストの上限があります。

1. 支払う金額を確認します: GET /api/v1/prices?country=gb&service=yahoo（gb は任意の api_country ID に置き換えられます）。
2. POST /api/v1/activations に {"service": "yahoo", "country": "gb"} を送ってアクティベーションを開始します。
3. 返された番号を Yahoo の電話番号ステップに入力します。
4. activation.sms_received からコードを取得します。Webhook が未設定の場合は GET /api/v1/activations/{id} をポーリングします。
5. テストを中止するときは POST /api/v1/activations/{id}/cancel でキャンセルします。

Webhook は慎重に扱ってください。エンドポイントのシークレットで <t>.<raw body> に対する HMAC-SHA256 を再計算し、X-OTPRoute-Signature: t=<unix>,v1=<hex> の v1 と比較し、古いタイムスタンプは拒否します。さらにアクティベーション ID をキーにしてハンドラーを冪等にし、再配信されたイベントで同じ Yahoo のフォームが 2 回埋まらないようにします。エッジケースについてはOTP Webhook を HMAC で保護する方法で解説しています。

ダッシュボードで Yahoo の OTP を受け取るには？

1. サインインして OTP Gateway を開きます。
2. Yahoo を選び、テストに合った国を選びます。
3. 画面に表示された料金を確認して確定します。
4. 番号を Yahoo に入力してコードを要求します。
5. メッセージが届いたら、アクティベーションカードで確認します。

ルールは API とまったく同じです。1 回のアクティベーションにつきコードは 1 つで、受信待ちは 20 分間、何も届かない場合やキャンセルした場合は課金されません。

Yahoo のコードが届かないことがあるのはなぜですか？

メッセージを送るかどうか、またどの番号に送るかは Yahoo 側が判断します。地域やアカウントの種類によっては仮想番号を受け付けず、同じセッションからの繰り返しの要求を遅らせることもあります。コードが届かないときは次のとおりにしてください。

• アクティベーションをウィンドウの最後まで開いたままにします。送信が遅れて届く場合があります。
• 別の国のルートで同じフローを試します。
• すぐに再注文を繰り返さず、しばらく待ってから再試行します。
• 拒否はコードのバグではなく、サービス側の性質として扱います。

自動返金があるため、失敗した試行にコストはかからず、探索的なテストを低コストで進められます。

Yahoo で Dedicated Number が適しているのはどんなときですか？

一時的なアクティベーションはコード 1 つで終了します。サインアップのテストには十分ですが、共有の運用メールボックスの復旧用回線や、毎週コードでログインするステージングアカウントのように、来四半期もメッセージを受信し続けなければならない Yahoo の電話番号には向きません。

こうした用途には、Dedicated Number が適しています。更新が続く限り同じ回線を保持でき、SMS はダッシュボードと number.sms_received として Webhook で受信でき、料金は 1 か月 $1.95 からです。即時に購入できるのはアメリカとカナダだけです。2 つの製品の比較は仮想番号のページにあります。

Yahoo のテストで守るべき基本ルールは何ですか？

OTP Route は、ご自身のプロダクトのテスト、または実在する個人や企業に属する正当なアカウントの運用にのみ使い、アカウントは 1 人または 1 社につき 1 つとしてください。Yahoo の規約を守り、すべてのアクティベーションに OTP Route の Acceptable Use Policy が適用されることを忘れないでください。Yahoo は所有者の商標であり、OTP Route は Yahoo と提携していません。

料金は前払いの USD ウォレットで月額料金はなく、カードまたは USDT/USDC でチャージでき、チャージごとに PDF の請求書が発行されます。開発用アカウントは、エンドツーエンドの連携テスト向けにシミュレートされた番号とコードを返すサンドボックスモードを依頼できます。セットアップの手順は開発者向けページにあります。

よくある質問

物理的な SIM なしで Yahoo のサインインフローをテストできますか？

はい。OTP Route で yahoo サービスの番号を注文すれば、コードはダッシュボードまたは Webhook に届きます。20 分以内に Yahoo から何も届かなければ、全額がウォレットに戻ります。

Yahoo 用の仮想番号はいくらかかりますか？

アクティベーションは 1 コード $0.20 からで、正確な金額は国によって異なります。国 ID と yahoo を指定して GET /api/v1/prices を呼び出すと、リアルタイムの料金を確認できます。

一時的な番号を Yahoo の復旧用電話番号として使ってもよいですか？

いいえ。アクティベーションはコード 1 つで終了するため、後の復旧は失敗します。復旧や繰り返しのログインには、米国またはカナダの Dedicated Number が向いています。

Yahoo はすべての電話番号を受け付けますか？

必ずしもそうではありません。Yahoo は仮想番号を拒否したりリクエストを制限したりすることがあります。そのため OTP Route は、SMS が届かなかったアクティベーションを返金します。

Webhook イベントの重複で Yahoo のテストが壊れないようにするには？

処理済みのアクティベーション ID を保存し、重複したイベントは無視します。処理の前に必ず署名を検証してください。

Yahoo の電話番号にはどの国を選べますか？

Yahoo は現在 198 か国のルートで利用できます。最新の一覧は GET /api/v1/countries とダッシュボードで確認できます。

CI で Yahoo の SMS 認証テストを自動化できますか？

はい。Webhook またはポーリングで API を使い、開発用アカウントでサンドボックスモードを依頼すれば、パイプラインの実行ではシミュレートされた番号とコードを使えます。

サービス名はそれぞれの所有者の商標です。OTP Route はこれらの企業と提携していません。番号は合法的にご利用いただき、各サービスの利用規約および当社の利用規定に従ってください。