RESTコールとWebhookでバハマの+1 242のOTPを収集する

バハマOTP APIの連携には、どのリクエストが必要ですか?

バハマOTP APIの連携は、https://otproute.com/api/v1 に対する短い呼び出しの連鎖で、Developerコンソールで生成した or_live_ で始まるBearerキーで認可されます。バハマの国IDは bs で、whatsapp や telegram などのサービスIDはカタログから取得します。

1. GET /api/v1/services と GET /api/v1/countries でカタログを読み込み、表示名で照合する代わりに、IDを設定に保存します。
2. 注文のたびに GET /api/v1/prices?country=bs&service=<id> を呼び出します。レスポンスには現在の価格が含まれ、利用可否は一日の中で変わるため、今この瞬間にルートが開いているかも分かります。
3. 本文 {"service": "<id>", "country": "bs"} で POST /api/v1/activations を送ってアクティベーションを作成します。アクティベーションIDと+1 242番号が返ります。
4. その番号を、テスト対象製品の登録またはログインの手順に入力します。
5. Webhookでコードを待つか、GET /api/v1/activations/{id} をポーリングします。実行をきれいに中止するには、POST /api/v1/activations/{id}/cancel を使います。

1アカウントで最大10個のキーを持て、毎分300リクエストまで送れるので、ステージング、CI、チームメンバーのノートPCにそれぞれ別のキーを割り当て、個別に無効化できます。このSMS認証APIのパラメーターとレスポンスは、APIドキュメントに載っています。

+1 242のコード向けの署名付きWebhookは、どう検証しますか?

1回の手動確認ならポーリングで十分ですが、複数のスイートが並行して動くようになったら、プッシュ配信のほうがすっきりします。Developerコンソールで最大5つのエンドポイントを登録し、activation.sms_received、activation.expired、activation.cancelled を購読してください。

各配信には X-OTPRoute-Signature: t=<unix>,v1=<hex> が付きます。署名対象の文字列を <t>.<raw body> として組み立て、エンドポイントのシークレットでHMAC-SHA256を計算し、結果を v1 と定数時間の関数で比較します。届いたままのバイト列に対して処理してください。パースしたJSONを再シリアライズすると空白が変わり、ダイジェストが一致しなくなります。キャプチャされたリクエストが再生されないよう、数分以上古いタイムスタンプは拒否します。

ハンドラーはアクティベーションIDで管理し、冪等にしてください。再送された配信で、テストが二重に合格扱いになってはいけません。時計のずれやシークレットのローテーションについては、HMACによるOTP Webhookの保護の記事で解説しています。

バハマのルートで使えるサービスは?スタッフは手動で注文できますか?

バハマのルートには、現在900を超えるサービスが載っています。人気のあるものには、WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、X (Twitter)、ChatGPT (OpenAI)、Microsoft & Outlook、Amazon、Discord、LinkedIn、Uber、Airbnb、Signalがあります。このリストはスナップショットとして扱ってください。重要なのは、注文時のAPIレスポンスです。

キーに触れない同僚も、ブラウザで同じ結果を得られます。サインインしてOTP Gatewayを開き、バハマとサービスを選び、表示された価格を確認して注文します。バハマの認証番号がカウントダウンとともに表示され、同じ画面にコードが届いたら表示されます。

20分の有効時間内には何が起こり、何も届かなかったらどうなりますか?

アクティベーションは、すべて20分間有効です。その間にSMSが届けば表示価格が課金され、何も届かないまま時間切れになった場合や、その前にキャンセルした場合は、全額が自動的にウォレットに戻ります。

バハマのコードが現れないときは、次の点を確認してください。

• テストを失敗と判断する前に、有効時間を最後まで待ちます。送信が遅いところもあります。
• 後でもう一度試すか、別のサービスルートを試します。在庫や送信元の挙動は、一日の中で変わるためです。
• そのサービスが仮想番号を受け付けるか、まず確認します。拒否するところもあり、返金の仕組みがあるのはまさにそのためです。
• 短い間隔での再注文は避けます。試行の間隔を空けて、不安定なテスト1つがリクエストの枠を食いつぶさないようにします。

そのほかのトラブルシューティングのパターンは、OTP配信失敗を減らすにまとめています。

+1 242番号は、どう保存・正規化すべきですか?

バハマは北米番号計画の一部なので、番号は米国やカナダと国コード1を共有しています。完全な番号は、1、市外局番242、7桁の加入者番号で、E.164では +1242 に7桁を続けた、合計11桁になります。住民は現地の7桁だけを伝えることが多い一方、計画内の他の地域からの発信者は、242の前に先頭の1をダイヤルします。

コード上では、次の2点が重要です。+1だけで国を推測する検証は、バハマの利用者を米国人と判定してしまうため、市外局番を調べるか、NANPの領域を扱える番号ライブラリを使ってください。そして、すべての番号をE.164で保存し、書式は表示のためだけに整えると、照会と重複排除の一貫性が保たれます。バハマの回線への認証テキストは、公用語である英語で届くのが通常なので、ローカライズの確認は、翻訳された文面ではなく、番号の書式と国のラベルに集中できます。

なぜプロダクトチームはバハマで登録をテストするのですか?

バハマの経済を支えているのは観光、ホスピタリティ、金融サービスで、予約プラットフォーム、配車・配達アプリ、決済製品、カリブ地域に顧客を持つ銀行はいずれも、+1 242の利用者向けに動く経路を必要としています。+1 242のテスト用番号があれば、QAエンジニアは、フォームがその番号を受け付けること、国選択がバハマを米国に含めず表示すること、SMS同意の文言が正しく表示されることを確認できます。適切なOTPルーティングとは、テストケースごとに正しい国を選ぶことであり、本土の番号を既定にすることではありません。自動テストスイートへの組み込み方は、QAテストのプレイブックで紹介しています。確認はすべて自社が所有するアカウントで行い、各サービスの規約に従ってください。すべての注文に、OTP Routeの利用規定(Acceptable Use Policy)が適用されます。

バハマの長期番号は可能ですか?利用料金はどう課金されますか?

バハマにはセルフサービスの長期番号はありません。専用番号は米国とカナダ向けの製品で、月額$1.95から、受信・送信SMS、ブラウザ通話、Webhook転送が付きます。バハマの継続的な回線が必要な場合は [email protected] までメールしてください。何が可能かは現地の規制によるため、お約束はできません。

利用料金は、月額料金もプラン選択もない、前払い式のUSDウォレット1つから差し引かれます。カードまたはUSDT/USDCでチャージでき、チャージごとにPDFの請求書が受信トレイに届きます。連携開発では、開発アカウントをサンドボックスに切り替えるよう依頼してください。シミュレートされた番号とコードが返るので、ウォレットの資金を使わずにフロー全体を試せます。課金の見え方は料金ページで確認できます。

よくある質問

現地のSIMなしで、自社アプリのバハマ向け登録フローをテストできますか?

はい。テストするサービス向けの+1 242番号をOTP Gatewayで注文してフローに入力し、ダッシュボードまたはWebhookでコードを読み取ります。料金は$0.20/コードからで、SMSが届いたときだけ課金されます。

APIでのバハマの国IDは何ですか?

bs です。GET /api/v1/prices と、POST /api/v1/activations の本文に指定します。

電話番号ライブラリは、+1 242を米国の番号として扱いますか?

国コードだけで国を推測する場合に限ります。市外局番を確認するか、NANPの領域データを持つライブラリを使い、バハマの番号が正しくラベル付けされるようにしてください。

コードが届かなかった場合、料金は発生しますか?

いいえ。20分以内に何も届かない場合、またはキャンセルした場合は、全額がウォレットに自動で戻ります。

今後のログインのために、バハマの認証番号を保持できますか?

セルフサービスの製品としてはできません。長期の専用番号は米国とカナダにしかありません。バハマの回線については [email protected] にメールすると、現地の規制で何が可能かをチームがお答えします。

テストスイートは、何リクエストまで送れますか?

1アカウントにつき毎分300リクエストまでで、最大10個のAPIキーに分けて使えます。数秒おきのポーリングか、Webhookへの切り替えで、余裕を持って範囲内に収まります。

ウォレットをステーブルコインでチャージできますか?

はい。ウォレットはカードとUSDT/USDCに対応しており、チャージのたびにPDFの請求書がメールで届きます。

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