使い切りか長期か?認証テストに向く+1 787ルートの選び方

プエルトリコのプロジェクトには、OTP GatewayとDedicated Numberのどちらが向いていますか?

まず、その番号をどれだけの期間使うかを考えます。OTP Gatewayは、ちょうど1つのコードのために+1 787番号を発行します。サインアップのテスト、ローカライズの確認、一度認証して終わるCIジョブに適しています。Dedicated Numberは手元に維持する回線で、来週もまたログインが必要なステージングアカウントや、共有のサポート用受信箱に向いています。

プエルトリコの場合、選択肢は実質的に決まっています。島は米国の準州ですが、その番号はセルフサービスのDedicated Number在庫に含まれません。この製品の対象は米国とカナダで、月額$1.95からです。繰り返し使うアカウントに米国本土の回線で足りるなら、仮想番号のページで選択肢を確認できます。プエルトリコの長期回線が特に必要な場合は、[email protected] までメールしてください。手配できるかどうかは現地の規則によるため、確約はできません。

プエルトリコOTP APIで、アクティベーションの作成と取得に使う呼び出しはどれですか?

APIは https://otproute.com/api/v1 にあり、or_live_ で始まるBearerキーが必要です。プエルトリコの国IDは pr です。

1. GET /api/v1/services と GET /api/v1/countries でIDを取得し、デプロイごとにキャッシュします。
2. 価格を確認します。GET /api/v1/prices?country=pr&service=<id> が現在の金額を返し、ルートが開いているかも分かります。
3. POST /api/v1/activations で注文します。ボディは {"service": "<id>", "country": "pr"} です。
4. 返された番号を、テスト対象のフローに入力します。
5. コードは、Webhookの activation.sms_received で受け取るか、GET /api/v1/activations/{id} をポーリングして取得します。
6. ジョブが途中で止まった場合は、POST /api/v1/activations/{id}/cancel でキャンセルします。

Webhookの呼び出しには X-OTPRoute-Signature: t=<unix>,v1=<hex> が付きます。エンドポイントのシークレットで <t>.<raw body> のHMAC-SHA256を再計算し、定数時間で比較し、古いタイムスタンプは拒否し、処理済みのアクティベーションIDの重複イベントは無視してください。1アカウントあたりキー10個、Webhookエンドポイント5つ、毎分300リクエストまで利用できます。詳しくはOTP API連携ガイドをご覧ください。

+1 787と+1 939の番号がフォームで問題になりやすいのはなぜですか?

プエルトリコは北米番号計画に属しているため、番号は米国の番号と同じ形です。国番号は1、3桁の市外局番(787、またはオーバーレイの939)、続く7桁で、E.164では +1787 または +1939 に7桁を続けて表記します。

この似ていることが、実際のバグの原因になります。アプリによっては、プエルトリコをISOコードPRの独立した国として扱い、米国に統合しているものもあります。住所フォームが州の値としてPRを期待する場合もあります。国の選択欄、電話番号の検証、住所の項目が互いに矛盾していないか、そしてプエルトリコを選んだユーザーに+1番号が無効だと表示されないかを確認してください。番号はE.164で保存し、地域は先頭の+1ではなく市外局番から判断します。

プエルトリコのSMS OTPコードを受信できるサービスは?

プエルトリコのルートでは、現在900を超えるサービスが利用できます。よく使われる送信元には、WhatsApp、Uber、Google(Gmail & YouTube)、Facebook、Instagram、TikTok、X (Twitter)、Amazon、ChatGPT (OpenAI)、Microsoft & Outlook、LinkedIn、Discord、Airbnb、Netflix、Telegramがあります。利用可否は1日の中で変わるため、一覧よりも、注文時にAPIが返す結果を信頼してください。

コードを書かずに使うには、ダッシュボードでOTP Gatewayを開き、プエルトリコとサービスを選び、表示された価格を確認して注文します。プエルトリコの認証用番号がカウントダウンとともに表示され、SMSが届くとその横にコードが表示されます。

20分以内にコードが届かない場合はどうなりますか?

各アクティベーションの有効時間は20分で、課金されるのはコードが届いたときだけです。時間内に何も届かなかった場合や、キャンセルした場合は、全額がウォレットに自動的に戻ります。

プエルトリコのコードが届かない場合は、次を試してください。

• テストを失敗とみなす前に、アクティベーションの有効時間いっぱいまで待ちます。
• 少し時間を置いて再試行するか、別のサービスルートを選びます。
• サービスが仮想番号を受け付けるか確認します。拒否するサービスもあり、返金はその場合のためにあります。
• 新しい注文を短い間隔で繰り返さず、試行の間に指数バックオフを入れます。

より広いパターンについては、OTP配信失敗を減らす方法をお読みください。

プエルトリコ向けに、スペイン語と英語のフローを確認するのはなぜですか?

スペイン語と英語はどちらも公用語で、日常的に最もよく使われているのはスペイン語です。そのため、プエルトリコはバイリンガルのオンボーディングを確認するのに適した場所です。アプリがスペイン語に設定されているとき、認証SMSはスペイン語で届くか。コード入力画面はアクセント付きの文言を正しく扱えるか。フローの途中でユーザーが言語を切り替えたとき、適切なテンプレートが送られるか。島は米ドルを使い、すでに多くの米国企業がサービスを提供しているため、米国での展開を広げる決済アプリ、配達プラットフォーム、マーケットプレイス、銀行は、テスト用に+1 787番号を必要とすることがよくあります。これらの確認は、自分で管理しているアカウントで行い、各サービスの利用規約に従い、OTP Routeの利用規定(Acceptable Use Policy)の範囲内で実施してください。自動化するには、CI/CDテストをご覧ください。

プエルトリコのテストでは、ウォレットとサンドボックスはどう使いますか?

サブスクリプションはありません。1つのプリペイドUSDウォレットですべての注文をまかない、月額料金もプランの選択もありません。カード、またはUSDT/USDCでチャージでき、チャージと番号の購入ごとにPDFの請求書がメールで届きます。本番に入る前に、開発アカウントをサンドボックスに切り替えるよう依頼すれば、シミュレートされた番号とコードが返るため、資金を使わずにOTPルーティングのフロー全体を試せます。準備ができたら、メールと6桁のコード、またはGoogleサインインでアカウントを作成し、チームでTOTPの二要素認証を有効にしてください。

よくある質問

現地のSIMカードなしで、プエルトリコのサインアップフローをテストできますか?

はい。OTP Gatewayで+1 787番号を注文してアプリに入力し、コードはダッシュボード、またはSMS認証APIとWebhookで受け取れます。

APIでは、プエルトリコは米国として扱われますか?

いいえ。独自の国ID pr があり、価格の照会やアクティベーションのリクエストでは、米国のIDではなくこれを使います。

+1 787のDedicated Numberを購入できますか?

ダッシュボードからは購入できません。セルフサービスのDedicated Numberは米国とカナダのみです。プエルトリコの回線については、[email protected] にメールでお問い合わせください。

認証SMSはスペイン語で届きますか?

送信元によって異なり、多くの場合はアプリの言語設定に従います。プロダクトが両方に対応しているなら、スペイン語と英語の両方のロケールをテストしてください。

プエルトリコの番号では、どの市外局番が表示されることがありますか?

プエルトリコでは787と939が使われています。どちらを受け取っても、記録が一貫するようにE.164で保存してください。

プエルトリコの認証コードはいくらですか?

1コード$0.20からです。サービスごとの正確な価格は GET /api/v1/prices とダッシュボードで確認でき、コードが届かなければ課金されません。

並列で何件のテストを実行できますか?

アカウントでは、毎分300リクエストとキー10個まで利用できます。この枠の大半はポーリングに使われるため、並列ジョブにはWebhookのほうが余裕を持てます。

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