OTPルーティングでオーストラリアのSMS認証コードを受信する

オーストラリアの認証用番号が必要になるのはなぜ?

オーストラリアは、北米と英国以外で、プロダクトが最初に展開する英語圏の市場であることが多く、電話番号欄、同意文言、SMSのステップのすべてを、公開前に実際の+61で一度通してみる必要があります。ローカライズの確認は言語だけにとどまりません。豪ドル表記の価格、日付は日が先の書き方、そして複数のタイムゾーンがあり、そのうちクイーンズランド州は夏時間を採用しない一方、採用する地域もあります。

オーストラリアのルートを注文する典型的な理由は次のとおりです。

• コードを送る前に国番号を検証する登録フローの公開前QA(QAテスト)。
• APACリージョンを開設するSaaSプロダクトのオンボーディング確認(SaaSオンボーディング)。
• シドニーやパースのチームが、社員の個人携帯を明かさずにビジネスアカウントを認証する必要がある地域運用。

オーストラリアOTP APIはどう呼び出す?

すべてのリクエストは https://otproute.com/api/v1 に送り、Developerコンソールで発行した or_live_ で始まるBearerキーを使います。オーストラリアの国IDは au です。

1. GET /api/v1/services でサービスIDを調べます。
2. GET /api/v1/prices?country=au&service=<id> で最新の見積もりを確認します。
3. POST /api/v1/activations にボディ {"service": "<id>", "country": "au"} を送ってアクティベーションを作成します。
4. テスト対象のアプリで認証SMSを発生させ、activation.sms_received イベントを待つか、GET /api/v1/activations/{id} をポーリングします。
5. テストを中止する場合は、POST /api/v1/activations/{id}/cancel で番号を解放します。

処理能力は毎分300リクエストの上限を前提に計画してください。1アカウントで10個のキーと5つのWebhookエンドポイントを持てます。完全なリファレンスはドキュメントにあり、プッシュモデルについてはWebhookによるOTP取得で詳しく解説しています。

コードに触れない同僚も、ブラウザで同じことができます。サインインしてOTP Gatewayを開き、オーストラリアとサービスを選び、表示された価格を確認して確定します。+61番号がすぐに表示されるので、アプリに貼り付けて、隣にコードが現れるのを待ちます。

+61番号にコードを送れるアプリは?

オーストラリアのルートは現在、1,800を超えるサービスを掲載しています。リアルタイムのスナップショットで人気のものには、WhatsApp、Telegram、Google (Gmail & YouTube)、Instagram、TikTok、Discord、Snapchat、LinkedIn、Uber、Microsoft & Outlook、Amazon、Airbnb、eBay、ChatGPT (OpenAI)があります。空き状況は日中に変動するため、先週キャッシュした一覧ではなく、GET /api/v1/services と価格エンドポイントを、信頼できる情報源として扱ってください。

+61の携帯番号はどう保存すべき?

オーストラリアのトランクプレフィックスは0です。国内で04xx xxx xxxと書く携帯番号は、E.164では+61 4xx xxx xxxになります。0を取り除き、続く9桁を残してください。データベースにはE.164形式を保存し、国内形式は表示のときだけ整形します。

テストケースにしておきたい、よくあるバリデーターのバグは次のとおりです。0061 を貼り付けるユーザー、0を残したまま +61 04… と入力するユーザー、番号の途中にスペースがあるケース。オーストラリアのアカウント向けのコードは通常英語で届くため、メッセージ本文をOCRや正規表現で解析する際に、ロケール処理がほとんど必要ありません。

オーストラリアのコードが届かない場合は?

各番号は20分間有効です。課金されるのはコードが届いたときだけで、有効時間が終了した場合、またはその前にキャンセルした場合は、全額が自動的にウォレットへ戻ります。

• 失敗と判断する前に有効時間を最後まで待ち、短い間隔で繰り返し注文するのは避けます。
• 少し時間を置いて再試行するか、別のサービスルートがあればそちらを試します。
• 対象サービスが仮想番号をそもそも受け付けるか確認します。拒否するサービスもあり、そのために返金があります。

テストスイートのリトライ設計については、OTP配信失敗を減らすで扱っています。

オーストラリアの長期回線はある?課金の仕組みは?

オーストラリアにはセルフサービスの長期番号はありません。専用回線は米国とカナダ向けの製品で、月額$1.95からです(仮想番号)。オーストラリアに関するご要望は [email protected] までご連絡ください。現地の規制のもとで選択肢があるかどうかをチームがお答えしますが、あるとは限りません。

課金は、月額料金のない、前払い式のUSDウォレット1つです。カードまたはUSDT/USDCでチャージでき、チャージごとにPDFの請求書がメールで届きます。詳細は料金ページをご覧ください。リクエストにより開発アカウントをサンドボックスに切り替えられ、ウォレット資金を使わずにエンドツーエンドのテスト用として、シミュレートされた番号とコードが返ります。

よくある質問

現地SIMを買わずに、オーストラリアの登録画面をテストできますか?

はい。OTP Gatewayで au のアクティベーションを注文し、+61番号をアプリに入力すれば、コードがダッシュボードに表示されるか、Webhookに届きます。

OTP Routeはオーストラリアにどの国IDを使いますか?

IDは au です。アクティベーション作成時の country フィールドと、価格の問い合わせに指定します。

アプリが+61番号を求めるとき、先頭の0は残しますか?

いいえ。国番号を選択した状態で、0の後ろの9桁を入力します。モバイルなら4から始まります。

オーストラリアのコードはいくらかかりますか?

$0.20/コードからです。オーストラリアの各サービスにはそれぞれの見積もりがあり、注文の前に GET /api/v1/prices で確認できます。

来月、同じ+61番号でチームがログインし直せますか?

確実にはできません。OTP Gatewayの番号は1回の認証に対応するためです。繰り返しログインするには、米国またはカナダの専用番号(Dedicated Number)が適しています。

サービスがSMSを送ってこなかった場合、残高はどうなりますか?

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

+61連携を無料でエンドツーエンドに予行演習する方法はありますか?

はい。サポートに依頼して開発アカウントをサンドボックスに切り替えてください。番号とコードがシミュレートされるため、ポーリングやWebhookのコードをエンドツーエンドで動かせます。

守るべき利用ルールはありますか?

はい。各サービスの利用規約とOTP Routeの利用規定(Acceptable Use Policy)に従ってください。このプラットフォームは、自社の正当なアカウントや製品のテストと運用のためのものです。

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