アルバの認証番号:+297のコードをテスト実行に取り込む

アルバの+297番号計画について、エンジニアは何を知っておくべきですか?

アルバはオランダ王国を構成する国で、オランダの+31とは別の独自の国番号+297を持っています。加入者番号は7桁で、トランクプレフィックスはないため、現地の人がフォームに書く番号がそのまま完全な国内有効番号です。

この単純さが、古典的な検証バグを隠しています。多くの登録フォームは、チームが大きな市場でしかテストしてこなかったために最低8桁や10桁を要求し、アルバの利用者はコードが送られる前にエラーに遭います。次のルールで整理できます。

• すべての番号を、スペースや句読点なしのE.164形式(たとえば +2975XXXXXX)で保存します。
• 入力では、スペース、ハイフン、先頭の 00 を取り除き、利用者が国メニューでアルバを選んでいれば +297 を前に付けます。
• 0 は決して追加しません。アルバには復元すべきトランク桁がありません。
• 桁数の検証は手書きのチェックではなく、メンテナンスされた電話番号ライブラリに任せます。

テスト用の実際の+297番号を使えば、フォーム、データベースの列、SMS送信の三者がこの7桁の形式で一致していることを最も手早く確認できます。

なぜチームはアルバの番号でQAを行うのですか?

島の経済は観光で成り立っているため、最も気にするのは予約エンジン、レンタルや配車アプリ、ホスピタリティ向けソフトウェア、旅行系フィンテック、ロイヤルティプログラムです。オランダ領カリブ地域に展開するチームは、アルバ、キュラソー、シント・マールテンを同時に立ち上げ、3つの国番号すべてをカバーする1つの回帰テストスイートを求めることがよくあります。

言語も重要です。公用語はオランダ語とパピアメント語で、店やホテルでは英語とスペイン語もどこでも通じます。グローバルサービスは通常、英語かアカウントの言語でコードを送るので、パーサーは固定の文面に一致させるのではなく、パターンで数字を抽出するようにしてください。インターフェースにオランダ語やパピアメント語の文字列があるなら、アルバの認証番号を使えば、QAは電話番号欄のラベルからコード入力画面まで、ローカライズされたジャーニー全体を確認できます。

+297番号にコードを配信できるサービスは?

アルバの最新スナップショットには、WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、ChatGPT (OpenAI)、Microsoft & Outlook、Amazon、Discord、Uber、Airbnb、Signal、LinkedInといった人気のルートが載っています。OTP Gatewayでは、この国全体で600を超えるサービスに対応しています。

提携キャリアが在庫を入れ替えるため、利用可否は一日の中で変動します。OTP Routeが静的な表ではなくリアルタイムで公開しているのはそのためです。テストフィクスチャにサービスの一覧を固定で書き込むのではなく、実行のたびにカタログを照会してください。

アルバOTP APIのリクエストは、最初から最後までどう流れますか?

or_live_ で始まるBearerキーで認証します。Developerコンソールでは、最大10個のキーと5つのWebhookエンドポイントを持て、上限は毎分300リクエストです。ベースURLは https://otproute.com/api/v1 です。

1. GET /api/v1/countries と GET /api/v1/services を一度呼び出してIDをキャッシュします。アルバは aw です。
2. GET /api/v1/prices?country=aw&service=airbnb で現在の価格を取得し、確定する前にジョブがコストを記録できるようにします。
3. POST /api/v1/activations にJSON本文 {"service": "airbnb", "country": "aw"} を送って注文します。レスポンスに、アクティベーションIDと、テスト対象のアプリに入力する+297番号が含まれます。
4. WebhookリスナーでこのオーダーのWebhook activation.sms_received を受け取ります。公開エンドポイントがないジョブは、代わりに数秒おきに GET /api/v1/activations/{id} を確認できます。
5. テストを中止する場合は、POST /api/v1/activations/{id}/cancel で注文を解放します。

すべてのWebhookには X-OTPRoute-Signature: t=<unix>,v1=<hex> が付きます。エンドポイントのシークレットで <t>.<raw body> のHMAC-SHA256を再計算し、定数時間で比較し、古いタイムスタンプのリクエストは破棄してください。ハンドラーの全体像はWebhookによる認証コード取得ガイドで、このSMS認証APIの全フィールドはAPIドキュメントで解説しています。

コードを書かない人もアルバの番号を注文できますか?

はい。サポート担当者やプロダクトマネージャーは、ブラウザから同じことができます。

1. サインインして、ダッシュボードのOTP Gatewayページを開きます。
2. 国にアルバを選び、確認したいサービスを選びます。
3. 表示された価格を確認し、表示された+297番号をコピーします。
4. アプリに入力してコードをリクエストします。SMSが届くと、注文カードに表示されます。

番号1つにつき、扱えるのは1つのサービスの認証コード1回分です。別々の確認ごとに、新しい注文を開始してください。

アルバの番号にコードが届かなかったらどうなりますか?

注文は20分間有効です。その間にSMSが届かない場合、またはその前にキャンセルした場合は、全額が自動的にウォレットに戻ります。料金が発生するのは、コードが実際に届いたときだけです。配信速度はサービスやルートによって異なるため、1分で諦めず、有効時間を最後まで待ってください。

ルートで空振りが続く場合は、次を試します。

• 在庫が入れ替わった後に再試行するか、同じフローで別のサービスルートを試します。
• そのサービスが仮想番号を拒否しないか確認します。拒否するところもあり、返金の仕組みがあるのはそのためです。
• CIからの連続注文ではなく、再試行の間隔を空けます。

さらなるヒントは、OTP配信失敗を減らすのメモにあります。

+297の長期回線はありますか?課金の仕組みは?

アルバにはセルフサービスの長期番号はありません。専用番号は米国とカナダ向けの製品で、月額$1.95からです。運用でアルバの回線が本当に必要な場合は [email protected] にメールしてください。チームが現地の規制で何が可能かを確認しますが、手配できるとは限りません。

それ以外はすべて、月額料金もプラン選択もない、前払い式のUSDウォレット1つで行います。カードまたはUSDT/USDCのステーブルコインでチャージでき、チャージのたびにPDFの請求書がメールで届きます。開発中は、リクエストにより開発アカウントをサンドボックスに移せます。シミュレートされた番号とコードで、ウォレットの資金を使わずにOTPルーティングのロジックを検証できます。最新の料金は料金ページにあります。このサービスは自社の製品とアカウントにのみ使用し、各アプリの規約に従ってください。また、OTP Routeの利用規定(Acceptable Use Policy)が適用されます。

よくある質問

島のSIMがなくても、ホテルアプリのアルバ向け登録をテストできますか?

はい。OTP Gatewayでアルバの番号を注文してアプリに入力すれば、ダッシュボードまたはWebhookでコードを読み取れます。

OTP Route APIでのアルバの国IDは何ですか?

すべてのリクエストで aw を使います。例:GET /api/v1/prices?country=aw&service=whatsapp。

アルバの番号には先頭に0を追加すべきですか?

いいえ。アルバにトランクプレフィックスはないため、保存する形式は +297 に7桁を続けたものです。

アルバのSMS OTPを受信するにはいくらかかりますか?

アルバのルートは$0.20/コードからで、サービスごとの金額はリアルタイムで決まります。その正確な金額は GET /api/v1/prices から取得でき、確定する前にダッシュボードにも表示されます。

1つの+297番号で、来週2つ目のログインコードを受信できますか?

いいえ。ゲートウェイの番号は1回分の認証コード用です。後で再ログインが必要なアカウントには、米国またはカナダの専用番号のほうが向いています。

OTP Routeで、プラットフォーム上に大量のアカウントを開設できますか?

いいえ。自社の認証フローのテストと、自社の正当なアカウントの運用のためのサービスで、各プラットフォームの規約と当社の利用規定(Acceptable Use Policy)が適用されます。

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