アンギラ(+1 264)の認証コード:チェックリスト、API手順、対処法

事前チェックリスト:最初のアンギラ注文の前に何を準備すべきか?

このリストを一度確認しておけば、最初の本番テストはたいていスムーズに進みます。

• APIキー。 Developerコンソールで作成します。キーは or_live_ プレフィックス付きで、1アカウントに最大10個持てるので、ステージングとCIには専用のキーを割り当ててください。
• ウォレットの残高。 スイートの冒頭で GET /api/v1/balance を呼べば、途中ではなく早い段階で実行を失敗させられます。
• 正しい国ID。 APIではアンギラは ai です。この2文字のコードは、設定ファイル内の別の「AI」という表記と混同しやすいので、名前付き定数として保持してください。
• サービスID。 推測ではなく GET /api/v1/services から取得します。
• Webhookエンドポイント(任意)。 コンソールで登録し、シークレットを保管し、ハンドラーが待機中のテストをどう特定するかを決めておきます。
• 米国以外でも+1を受け付ける電話番号欄。 チームが最も遅く気づきやすい項目です。理由は次のセクションで説明します。

費用をかける前にすべてを配線しておきたい場合は、サポートに依頼して開発アカウントをサンドボックスに切り替えてもらってください。シミュレートされた番号とコードが返ります。

+1 264番号が電話番号バリデーションで引っかかるのはなぜ?

アンギラは北米番号計画(NANP)に属しているため、米国、カナダ、多数のカリブ海の地域と国番号+1を共有しています。この島を識別するのは市外局番264です。アンギラの番号は+1、264、7桁の順で、プラス1の後ろは合計10桁です。NANPでは国内トランクプレフィックスが1なので、現地の資料では同じ回線が1-264-xxx-xxxxと書かれることがあります。

この共通の国番号は、よくあるバグを生みます。

• +1の番号をすべてアメリカのものとして扱い、米国の州に対応付けようとするフォーム。
• +1で始まるものすべてに「US」を保存し、分析やSMSポリシーの照会を歪める国選択UI。
• 認識できない市外局番を拒否するバリデーター。

番号はE.164形式で +1264 に7桁の加入者番号を続けて保存し、国番号だけでなく、メンテナンスされている番号ライブラリを使って完全なプレフィックスから地域を判定してください。公用語は英語なので、このルートの認証SMSは通常サービスの英語テンプレートで届き、コードの抽出も簡単です。このルートをテストするのは、東カリブ海地域に展開するとき、観光・ホスピタリティ関連の顧客にサービスを提供するとき、あるいは50州の外でもNANPの処理が正しく動くことを確かめたいときなどです。

手順:APIでアンギラの番号を注文する

すべての呼び出しは https://otproute.com/api/v1 に対して行い、Bearerヘッダーにキーを付けます。

1. GET /api/v1/countries でルートを確認し、その日のうちはレスポンスをキャッシュします。
2. GET /api/v1/prices?country=ai&service=<id> で最新価格を取得します。価格と空き状況は日中に変動するため、ハードコードせず実行ごとに問い合わせてください。
3. POST /api/v1/activations に {"service": "<id>", "country": "ai"} を送ってアクティベーションを作成します。レスポンスにはアクティベーションIDと+1 264番号が含まれます。
4. その番号を、テスト対象プロダクトの登録またはログイン画面に入力します。
5. Webhookで activation.sms_received を待つか、数秒おきに GET /api/v1/activations/{id} をポーリングします。毎分300リクエストの上限には十分な余裕があります。
6. テストを中止する場合は POST /api/v1/activations/{id}/cancel で注文を解放し、保留分をウォレットに戻します。

リクエストとレスポンスの完全なリファレンスはAPIドキュメントにあります。

アンギラのルートでコードを受信できるサービスは?

アンギラのルートは現在600を超えるサービスを掲載しています。本日のスナップショットで人気のものには、WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、X (Twitter)、ChatGPT (OpenAI)、Microsoft & Outlook、Amazon、Discord、LinkedIn、Uber、Airbnbがあります。島を訪れる旅行者を相手にするチームにとっては、旅行や配車のアプリが重要になりがちです。

この一覧は出発点であって保証ではありません。OTPルーティングネットワークの在庫は一日の中で変動します。だからこそ、価格エンドポイントは国とサービスの組み合わせごとにリアルタイムの空き状況を返します。

開発者以外はダッシュボードで同じテストをどう実行する?

プロダクトマネージャーやサポート担当者にAPIは必要ありません。サインインしたらOTP Gatewayを開き、アンギラとサービスを選び、注文前に表示される価格を確認して確定します。カウントダウン付きで番号が表示されるので、アプリに貼り付けてください。SMSが届くと、同じ画面にコードが表示されます。予定が変わったときのために、注文の隣にキャンセルボタンがあります。繰り返し行う回帰テストについては、QAテストガイドで、手動チェックと自動チェックの分担方法を紹介しています。

トラブルシューティング:アンギラのコードが届かない

チケットを作成する前に、次を順に確認してください。

• 有効時間を最後まで待つ。 アクティベーションは20分間有効です。最初の番号の1分後に2つ目を注文しても、注意が散るだけです。
• 受け付けを確認する。 仮想番号を拒否したり、新しい番号に独自のリスクルールを適用したりするサービスがあります。登録フォームが番号をその場で拒否する場合は、キャンセルして別のルートを選びます。
• 後で再試行するか、ルートを切り替える。 小さな島のルートは空き状況が変わります。時間を置いて再試行するか、同じフローを別の国でテストすると解消することがよくあります。
• 短い間隔の繰り返しを避ける。 ループで再注文するとレート制限を消費し、対象サービスの疑いを減らすどころか強めかねません。
• Webhookを確認する。 ハンドラーが X-OTPRoute-Signature を検証して成功を返しているか確認してください。定数時間比較とタイムスタンプのチェックは、HMAC検証ガイドで説明しています。

原因が何であれ、届かなかったコードには費用がかかりません。有効時間が空のまま終了したとき、またはキャンセルしたときは、全額がウォレットに自動で戻ります。

長期回線、ウォレット、請求書

アンギラは+1でダイヤルしますが、専用番号(Dedicated Numbers)の対象ではありません。セルフサービスの長期回線は米国とカナダのみで、月額$1.95からです。受信SMS、Webhook転送、ブラウザ通話が含まれます。詳しくは仮想番号をご覧ください。アンギラの長期回線が必要な場合は [email protected] にメールしてください。実現できるかどうかは現地の規制によります。

課金は、月額料金もプラン選択もない、前払い式のUSDウォレット1つです。カードまたはUSDT/USDCでチャージでき、チャージごとにPDFの請求書がメールで届きます。現在の料金は料金ページにあります。OTP Routeは、自社の製品とアカウントのテスト・運用を目的としており、各サービスの利用規約と当社のAcceptable Use Policyに従ってご利用ください。

よくある質問

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

はい。OTP Gatewayでワンタイムの+1 264番号を注文してアプリに入力すれば、ダッシュボードまたはAPIでコードを読み取れます。

OTP Route APIでアンギラに使う国IDは何ですか?

アンギラは ai です。価格取得とアクティベーションのリクエストの country の値として渡します。

+1 264番号は米国の番号として扱われますか?

そうなってはいけません。国番号+1は共有していますが、市外局番264はアンギラのものなので、地域の判定は完全なプレフィックスで行う必要があります。

アンギラの認証コードはいくらかかりますか?

コードは1コード$0.20からです。正確な金額はサービスによって異なり、注文前にダッシュボードと価格エンドポイントで確認できます。

番号にSMSが届かなかった場合はどうなりますか?

課金されません。コードが届かないまま20分の有効時間が終了した場合、またはその前にキャンセルした場合は、全額がウォレットに戻ります。

将来のログイン用に、アンギラの番号を保持できますか?

セルフサービスではできません。長期番号は米国とカナダ向けの製品です。それ以外については、チームにメールで問い合わせてください。

ウォレットにチャージする前にアンギラのテストを組み立てる方法はありますか?

はい。リクエストにより開発アカウントをサンドボックスに移行できます。エンドツーエンドのテスト用に、シミュレートされた番号とコードが返ります。

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