ニュージーランドのSMS OTPをAPIまたはダッシュボードで受信する

一時的な+64番号と長期回線、どちらが必要ですか?

先に適切な製品を選んでおくと、後からの作り直しを防げます。

OTP Gatewayを選ぶのは、テストやオンボーディングの手順でコードが1回だけ必要な場合です。新規QAアカウントの作成、ニュージーランド向け登録画面のスモークテスト、現地ユーザーのフローが最後まで通るかの確認などです。番号を取得してコードを1つ受け取れば、セッションは終了します。

専用番号を選ぶのは、同じアカウントが数週間後に再ログインする場合や、チームで共有するリカバリー用番号が必要な場合です。こうした長期回線は米国とカナダでのみ提供され、月額$1.95からで、受信SMSは number.sms_received イベントとして転送されます。

ニュージーランドについては、セルフサービスの長期番号はありません。必要な場合は [email protected] までメールしてください。可否は現地の規則によるため、お断りすることもあります。北米回線の通話、送信SMS、更新条件はバーチャル番号のページにまとめています。

なぜプロダクトチームはニュージーランドで登録をテストするのですか?

ニュージーランドは、英語圏アプリのソフトローンチ先としてよく選ばれます。ユーザー規模が小さく、言語が共通で、時間帯が早いため、全面リリース前に実際のオンボーディングを観察しやすい市場です。つまり、+64の認証ステップは新市場で最初に動く本番経路になることが多く、専用のテストケースを用意する価値があります。

押さえておきたい点は次のとおりです。

• 言語。 英語、マオリ語、ニュージーランド手話が公用語です。ほとんどのサービスは英語でコードを送りますが、自社のテンプレートでマクロン付きのマオリ語(ā、ō、ū)を使う場合、これらの文字はGSM-7の範囲外となり、SMSがUCS-2になって1通あたりの文字数が短くなります。
• 日付の境界。 ニュージーランドは新しい暦日を最も早く迎える地域の1つなので、日付を基準にした有効期限やレート制限のロジックが、現地ユーザーでは異なる挙動になることがあります。
• 市場適合性。 現地番号で認証したQAアカウントは、現地ユーザーが通るのと同じ国別ロジックを検証できます。

こうしたチェックを軸にしたリリースゲートの作り方は、QAテストのノートをご覧ください。

+64の携帯番号はどう保存し、正規化すればよいですか?

ニュージーランドの国内トランクプレフィックスは0です。国内表記の021 123 4567は、先頭の0を取り除いて+64を付けると、E.164形式の +64211234567 になります。0を除いた携帯番号は2で始まり、桁数は一定ではないため、桁数を1つに固定してはいけません。

スキーマ設計の実践的なルールです。

• 正規のE.164文字列を1つだけ保存し、表示用の整形は描画時にのみ行います。
• スペース、ハイフン、トランクの0が付いた入力も受け付け、メンテナンスされている電話番号パーサーのライブラリで正規化します。
• 国内表記と国際表記の両方に加え、ユーザーが+64と先頭の0を両方残したまま貼り付けた番号もテストデータに含めます。

OTP Routeでニュージーランドの番号にコードを送るアプリは?

+64ルートでは800を超えるサービスに対応しています。現在のスナップショットで利用の多いものは、Google (Gmail & YouTube)、WhatsApp、Telegram、Facebook、Instagram、TikTok、ChatGPT (OpenAI)、Claude、Microsoft & Outlook、Amazon、Discord、Snapchat、LinkedIn、Uber、Netflixなどです。

空き状況はリアルタイムで変わるため、リストを何週間もキャッシュせず、実行の開始時に GET /api/v1/countries と GET /api/v1/services を呼び出してください。+64で提供が少ないサービスがある場合は、英語圏での比較として近隣のオーストラリアルートが通常の代替になります。

ニュージーランドOTP APIのシーケンスはどうなっていますか?

+64に対するすべての呼び出しは、Developerコンソールで発行した or_live_ のBearerキーを付けて https://otproute.com/api/v1 に送ります。手順は次のとおりです。

1. GET /api/v1/prices?country=nz&service=uber でリアルタイムの価格を確認します。
2. POST /api/v1/activations に {"service": "uber", "country": "nz"} を送ってアクティベーションを作成します。
3. GET /api/v1/activations/{id} をポーリングしてコードを取得するか、activation.sms_received をWebhookで受け取ります。activation.expired と activation.cancelled は、後始末のタイミングを知らせます。
4. 使わない注文は POST /api/v1/activations/{id}/cancel でキャンセルし、残高は GET /api/v1/balance で確認します。

Webhookでは、エンドポイントのシークレットで <t>.<raw body> のHMAC-SHA256を計算して X-OTPRoute-Signature を検証し、古いタイムスタンプは拒否し、再送されても影響が出ないようにアクティベーションIDでハンドラーを冪等にしてください。詳しい手順は連携ガイドにあります。上限は1アカウントあたり1分300リクエストです。

開発者でなくてもニュージーランドの認証番号を注文できますか?

もちろんです。ダッシュボードでニュージーランドを選び、サービスを選択し、表示された価格を確認して注文を確定します。注文に+64番号が表示されるので、アプリに入力してSMSを要求すると、コードが届いた時点で同じカードに表示されます。すべて20分の有効時間内に行うため、注文の前に対象アプリを開いておいてください。

+64のコードが届かない場合はどうすればよいですか?

まず20分の有効時間を最後まで待ってください。送信元によっては、SMSの遅延やまとめ送信があるためです。それでも届かない場合は、サービスが仮想番号を拒否しているか、そのルートが混み合っている可能性があります。注文を連続で出すのではなく、時間をおいて再試行するか、別のサービスルートでテストしてください。応答のなかった注文や、キャンセルした注文は、ウォレットへ自動的に返金されます。課金はプリペイドUSDウォレットの従量制で、カードまたはUSDT/USDCでチャージでき、チャージごとにPDF請求書が発行され、月額料金はなく、ドライラン用のサンドボックスモードは申請により利用できます。OTP Routeは、ご自身の正当なアカウントとプロダクトのためのものであり、各サービスの利用規約と当社の利用規定(Acceptable Use Policy)が適用されます。

よくある質問

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

はい。OTP Gatewayで+64番号を注文し、登録フォームに入力して、コードをダッシュボードまたはAPIで読み取ってください。

ニュージーランドの携帯番号を保存するとき、0は残しますか?

いいえ。E.164ではトランクの0を取り除くため、021 123 4567は +64211234567 として保存します。

ニュージーランドのAPI国IDは何ですか?

nz です。価格の取得と、アクティベーションのリクエストボディで使います。

ニュージーランドの認証コードはいくらですか?

価格は$0.20/コードからで、サービスによって異なります。正確な金額は、注文前にダッシュボードと GET /api/v1/prices で確認できます。

ニュージーランドの番号を数か月間借りられますか?

セルフサービスの長期+64回線はありません。専用番号は米国とカナダ向けの製品で、他の国については [email protected] へメールでお問い合わせください。

+64のコードの受信には、ポーリングとWebhookのどちらが向いていますか?

単一のスクリプトならポーリングが簡単で、多数のテストジョブが並列で動く場合は署名付きWebhookのほうが拡張しやすいです。どちらも同じコードが返ります。

OTP Routeのニュージーランド番号は、すべてのアプリで受け付けられますか?

そうとは限りません。仮想番号を拒否するサービスもあり、SMSが届かなかった注文が自動返金されるのはそのためです。

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