米国(+1)の認証コードを取得:ワンタイム番号か、保持できる回線か

ワンタイムコードと米国の専用番号、どちらが必要ですか?

まず1つだけ確認してください。このアカウントは、同じ番号で今後もう一度コードが必要になりますか?

• OTP Gatewayは1回の認証イベントに対応します。サービスと us ルートを選ぶと+1番号が発行され、コードをちょうど1回受信します。自動テスト、オンボーディングQA、その番号で繰り返さないサインアップに向いています。
• 専用バーチャル番号は、使い続ける必要のあるあらゆる用途に対応します。ダッシュボードで即時に購入でき、ウォレットからのプリペイド期間で更新され、いつでも解放できます。毎週ログインするステージングアカウント、誰かの個人の電話に置くべきでない共有チームログインの復旧、サポートや運用の回線、米国でのビジネスプレゼンスに向いています。

多くのチームが両方を使い分けています。CIの中では使い捨てのサインアップにゲートウェイを、テスターが再利用する長期運用のQAアカウントには数本の専用回線を使います。両者の詳しい比較は一時番号と専用番号をご覧ください。

米国の専用回線には何が含まれますか?

OTP Routeの専用番号は、単なる受信箱ではなく、実際に使える回線です。

• 受信SMSはダッシュボードに表示され、number.sms_received イベントとしてWebhookにも転送されます。
• SMSの送信ができるため、サポートや運用担当が同じ番号から返信できます。
• ブラウザからの発信通話に対応し、アプリのインストールもSIMの管理も不要です。
• 月額$1.95からのプリペイド期間で、ウォレットから更新され、いつでも解放できます。

これらの回線は米国とカナダでのみ提供されており、チームが自分専用の番号をセルフサービスで保有できるのはこの2つの市場です。購入と更新についてはバーチャル番号のページで説明しています。

米国OTP APIでワンタイムの+1コードを取得するには?

自動化の場合、米国ルートは他のゲートウェイ対象国と同じように動作します。開発者コンソールで作成したBearerキー(プレフィックス or_live_)で https://otproute.com/api/v1 に認証し、次の手順に進みます。

1. GET /api/v1/prices?country=us&service=<id> でライブ価格を取得します。
2. POST /api/v1/activations でアクティベーションを開始します。ボディは {"service": "discord", "country": "us"} など、テストに必要なサービスIDを指定します。
3. 返された番号を、テスト対象のアプリに渡します。
4. activation.sms_received のWebhookからコードを取得するか、GET /api/v1/activations/{id} をポーリングします。
5. SMSの手順より前にテストが失敗した場合は、POST /api/v1/activations/{id}/cancel で問題なく中止できます。

Webhook側では、エンドポイントのシークレットをキーとした <t>.<raw body> のHMAC-SHA256である X-OTPRoute-Signature ヘッダーを確認し、古いタイムスタンプのイベントは破棄し、アクティベーションIDで重複を排除してください。上限はAPIキー10個、Webhookエンドポイント5つ、1分あたり300リクエストで、環境ごとに1つのキーを使う並列スイートには十分です。チームがこれをパイプラインに組み込む方法は、QAテストのページで紹介しています。

米国の番号で認証できるサービスは?

現在、米国ルートでは5,000を超えるサービスで認証できます。よく選ばれるのは、WhatsApp、Telegram、Google(Gmail & YouTube)、Instagram、TikTok、Discord、ChatGPT(OpenAI)、Claude、Microsoft & Outlook、Amazon、LinkedIn、Uber、Signal、Netflixなどです。

これはあくまでスナップショットとして扱ってください。注文できるものは一日の中で変わるため、このようなページではなく、APIから利用可否を読み取るようにコードを組みましょう。認証する対象は、自社のプロダクトか、事業として正当に運用しているアカウントに限り、各サービスの利用規約とOTP Routeの利用規定が適用されます。

技術に詳しくない同僚でも、米国の認証番号を注文できますか?

はい、ダッシュボードから可能です。米国を選び、サービスを選んで、確定する前に表示される価格を確認し、+1番号をサインアップフォームに貼り付けます。APIと同じ20分のアクティベーション時間内に、コードが画面に表示されます。時間切れまでにSMSが届かなかった場合、またはキャンセルした場合は、全額が自動的にウォレットへ戻るため、実際に届いたコードの分だけをお支払いいただきます。専用回線も同じダッシュボードから購入でき、その受信メッセージもそこに表示されます。

米国のコードがいつまでも届かない場合は?

• アクティベーションに時間の余裕を与えてください。20分の待機時間は、送信の遅い送信元のためにあります。
• そのサービスが仮想番号を受け付けているかを確認します。断るサービスもあり、自動返金はまさにそのケースのためのものです。
• 同じルートに繰り返しアクセスするのではなく、時間を置くか、別のサービスルートに切り替えます。
• 自動化スイートでは、注文の間にバックオフを入れてください。立て続けの再試行は時間を無駄にするだけです。

あるアカウントが何度もコードを必要とする場合は、いったん立ち止まって、新しいワンタイム番号ではなく専用回線に置くべきかを検討してください。

+1番号はどのように整形・保存すべきですか?

米国の番号は北米番号計画に従い、3桁の市外局番と7桁の加入者番号、合計10桁です。E.164形式では +1 の後ろにその10桁が続き、スペース、ダッシュ、括弧は付けません。ユーザーは先頭に 1 を付けたり、市外局番を括弧で囲んだりして入力しがちなので、保存前にそれらを取り除いてください。

複数の国に対応するプロダクトでは、1つ注意点があります。カナダといくつかのカリブ海の地域は +1 を共有しているため、ダイヤルコードだけでは国を判別できません。国は別フィールドで保持するか、メンテナンスされているライブラリで市外局番から導出してください。

米国の番号宛ての認証SMSはほとんどが英語で、スペイン語話者向けにローカライズされたアプリではスペイン語も見られます。多くのサービスは10桁の番号ではなくショートコードから送信するため、送信元フィルターは両方を許可するようにしてください。チームが+1番号をテストに使うのは、米国が最初のローンチ市場になることが多く、アメリカの顧客が+1のフローを前提にしており、米国の回線がパートナーやサポートにも役立つからです。

コードと回線の課金はどうなっていますか?

1つのプリペイドUSDウォレットが両方のプロダクトを賄い、月額料金もプラン選択もありません。チャージはカードまたはUSDT/USDCで行い、チャージや番号購入のたびにPDF請求書がメールで届きます。SMS認証APIを本番のテストに組み込む前に、サポートに依頼して開発用アカウントをサンドボックスにしてもらうと、シミュレートされた番号とコードが返され、資金を使わずにOTPルーティングの全フローを試せます。最新の金額は料金ページに掲載しています。

よくある質問

再ログインが必要なアカウントのために、米国の番号を保持できますか?

はい。ダッシュボードから専用バーチャル番号を購入してください。月額$1.95からでウォレットから更新され、解放するまで、宛てに送られたすべてのSMSを受信します。

米国のSIMカードなしで、アプリの米国向けサインアップフローをテストできますか?

はい。国ID us でOTP Gatewayから+1番号を注文し、サインアップを実行して、ダッシュボード、Webhook、またはポーリングでコードを読み取ります。

認証コードが届かなければ料金を支払いますか?

いいえ。20分以内に番号へ何も届かなかった場合、またはその前にキャンセルした場合は、全額が自動的にウォレットへ返金されます。

米国の専用番号で電話をかけられますか?

ブラウザから直接発信通話ができ、SMSも送信できます。アプリもSIMも不要です。

米国以外でも専用番号は利用できますか?

専用番号があるのはカナダだけです。それ以外の国では、OTP Gatewayがワンタイムコードに対応します。長期回線については [email protected] にメールでお問い合わせください。

OTP Routeには、米国の連携テスト用のサンドボックスがありますか?

はい、リクエストに応じて提供します。開発用アカウントをサンドボックスに切り替えると、ウォレットの資金を使わずに、シミュレートされた番号とコードがWebhookに届きます。

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