プログラムで Bumble の SMS コードを取得する

API は Bumble のコードをどう渡すのか？

OTP Gateway は Bumble をサービス ID bumble として扱います。呼び出しは、or_live_ で始まる Bearer キーを付けて https://otproute.com/api/v1 に送ります。

1. 市場を選びます。GET /api/v1/countries は gb や de などの ID を一覧にします。
2. 料金を確認します。GET /api/v1/prices?country=<id>&service=bumble
3. 注文します。POST /api/v1/activations に {"service": "bumble", "country": "<id>"} を送ります。アクティベーション ID と、アプリに入力する電話番号が返されます。
4. コードを取得するか（次のセクション）、実行を中止する場合は POST /api/v1/activations/{id}/cancel を呼び出します。

デーティングアプリのテストハーネスは通常、これをフィクスチャにまとめ、テストケースごとに新しい番号を返して、終了後に破棄します。エンドポイントの詳細はドキュメントにあります。

Bumble の OTP は Webhook とポーリングのどちらがよいか？

GET /api/v1/activations/{id} のポーリングは、ローカルスクリプトでは最短の方法です。デバイスファームや CI マトリクスでは、Webhook エンドポイントを登録して activation.sms_received、activation.expired、activation.cancelled を待ち受けます。

受信側の信頼性を保つ習慣が 2 つあります。

• 署名を検証する。 ヘッダー X-OTPRoute-Signature: t=<unix>,v1=<hex> は、エンドポイントのシークレットを鍵とする <t>.<raw body> の HMAC-SHA256 です。定数時間で比較し、古いタイムスタンプは拒否します。
• 冪等にする。 結果をアクティベーション ID をキーにして保存し、再配信されたイベントが何も変更しないようにします。

アカウントでは API キー 10 個、Webhook エンドポイント 5 個、1 分あたり 300 リクエストが利用でき、並列のテストスイートには十分です。

Bumble はどこで電話番号を求めるのか？

Bumble は電話番号での登録に対応しており、登録する人にその番号が属していることを確認するため、SMS でワンタイムコードを送ります。新しい端末でのログインやアプリの再インストール時にもコードが表示されることがあり、認証済みの番号は、後でアカウントに戻る際にも役立つことがあります。具体的な画面はアプリの進化とともに変わるため、固定のスクリプトではなく、実際に表示される画面に対してテストでアサートするようにしてください。

デーティングやソーシャルの製品を連携するチームにとって、これらの場面は重要です。国の選択、電話番号の入力マスク、コード入力画面、再送タイマーは、いずれもカバーする価値があります。パターンについてはモバイルアプリの認証をご覧ください。

Bumble のテスト用番号はどの国のものを使えるか？

bumble サービスは現在 202 か国に掲載されており、米国、英国、インド、オーストラリア、ブラジル、ドイツ、カナダ、メキシコ、フランス、アイルランド、スペイン、オランダ、ナイジェリア、南アフリカなどが含まれます。

テストが再現しようとしているシナリオに合わせて、発信元の国を選んでください。英国向けのビルド、ブラジルポルトガル語のロケール、インドのオンボーディングファネルは、それぞれその市場の電話番号を想定しており、アプリは地域によってコンテンツ、言語、認証ステップを変えることがあります。最新の提供状況は一日のなかで変わるため、実行時に問い合わせてください。

ダッシュボードから同じ確認を実行する

プロダクトマネージャーやサポート担当者は、API をまったく使わずに済ませられます。

1. OTP Gateway を開いて Bumble を検索します。
2. 国を選び、表示された料金を確認します。
3. 番号を Bumble の登録またはログイン画面に貼り付けます。
4. 20 分の有効時間内に、ダッシュボードにコードが表示されるのを確認します。

キャンセルした場合や、時間内に何も届かなかった場合は、金額がすぐにウォレットへ戻ります。ウォレットは USD のプリペイドで、カードまたは USDT/USDC で入金でき、月額料金はなく、入金ごとに PDF の請求書が発行されます。

Bumble のコードが届かないのはなぜか？

Bumble が仮想番号を拒否することもあれば、特定のルートがその時点で静かなこともあります。SMS が届かなかったアクティベーションは返金されるため、どちらでも費用はかかりません。実際の対処は次のとおりです。

• 失敗と判断する前に、有効時間が終わるまで待ちます。
• ループですぐに再注文せず、あとで、または別の国のルートで再試行します。
• Webhook のログで、署名が拒否されていないか確認します。
• 連携を構築している間は、サンドボックスアカウントを依頼します。シミュレートされた番号とコードが返るため、費用をかけずに仕組みをテストできます。

Bumble の OTP より専用番号のほうが適しているのはいつか？

使い切りの番号は、登録後に終わるテストに向いています。QA アカウントが来週もう一度ログインする必要があるなら、保持できる番号のほうが実用的です。米国とカナダの専用番号（Dedicated Numbers）は月額 $1.95 からで、ダッシュボードと number.sms_received で SMS を受信でき、いつでも解除できます。詳細は仮想番号のページをご覧ください。

どちらを選ぶ場合も、Bumble の規約を守ってください。アカウントは実在の個人または事業者につき 1 つで、重複したプロフィールはいけません。OTP Route は、ご自身の正当な製品とアカウントのテストと運用のためのサービスであり、利用規約（Acceptable Use Policy）が適用されます。Bumble はその所有者の商標であり、OTP Route は提携していません。

よくある質問

OTP Route の API での Bumble のサービス ID は何ですか？

bumble で、POST /api/v1/activations の service フィールドに渡します。

Bumble 用に仮想番号を使えますか？

試すことはできますが、Bumble が仮想番号を拒否することがあります。コードが届かなければ、請求はウォレットに戻ります。

Bumble の OTP を受信できる時間はどのくらいですか？

各アクティベーションは 20 分間開いており、1 つのコードに対応します。

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

はい。パイプラインからアクティベーションを作成して署名付き Webhook でコードを受け取るか、構築中はサンドボックスを使います。

Bumble の電話番号は、どの国を選ぶべきですか？

英国、インド、ブラジルなど、ビルドやテストアカウントが対象とする市場に合わせ、先に最新の提供状況を確認してください。

Bumble の番号は、あとのログインで再利用できますか？

Gateway の番号は使い切りです。繰り返しのログインには、保持できる米国またはカナダの専用番号のほうが適しています。

これらの番号で複数の Bumble プロフィールを作成できますか？

できません。Bumble の規約と OTP Route の利用規約（Acceptable Use Policy）を守ってください。番号は、ご自身の正当なアカウントのテストと運用のためのものです。

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