アゼルバイジャンのSIMを持つ人がいなくても+994の登録フローをテストする

バクーでの公開を控えていますが、認証の手順がすべてのテストを止めています。どんな選択肢がありますか?

これは、既存のアプリにアゼルバイジャンを追加するチームがよくつまずく場所です。電話番号の画面は+994を受け付け、ローカライズ済みの文言も用意できているのに、アゼルバイジャンのSIMを持っているのが別のタイムゾーンにいる外部委託先だけという理由で、QAが止まってしまいます。同僚の個人の携帯を借りれば一度は動きますが、テストアカウントが私的な番号に結びつき、パイプラインの中では実行できません。

OTP Gatewayなら、このボトルネックを解消できます。+994番号を1コード分だけ注文し、自社の登録画面やログイン画面で使い、誰もハードウェアを持たなくてもSMSを受け取れます。番号1つにつき認証は1回なので、テストデータがきれいに保たれ、個人の携帯がビジネスアカウントに紛れ込むこともありません。これをスプリントごとに回しているチームは、通常QAテストのワークフローと組み合わせています。

現在、アゼルバイジャンのルートにコードを配信できるアプリは?

アゼルバイジャンの最新スナップショットには、1,600を超えるサービスが載っています。人気のあるものには、WhatsApp、Telegram、Viber、Uber、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、Microsoft & Outlook、LinkedIn、Discord、Signal、Amazonがあります。

利用可否は固定ではありません。提携キャリアが容量を入れ替えるため、ルートは一日の中で開いたり閉じたりし、午前中に見えていたサービスが午後には消えていることもあります。リストを固定で書き込むのではなく、実行のたびにAPIから読み取り、組み合わせが提供されていなければ穏やかにスキップしてください。

アゼルバイジャンOTP APIを自動テストスイートに組み込むには?

すべての呼び出しは https://otproute.com/api/v1 に対し、Developerコンソールで取得したBearerキーを付けて送ります。キーは or_live_ で始まり、1アカウントで最大10個持てます。アゼルバイジャンの国IDは az です。

1. GET /api/v1/services と GET /api/v1/countries でカタログを取得し、GET /api/v1/prices?country=az&service=<id> で組み合わせを確認します。
2. POST /api/v1/activations に {"service": "viber", "country": "az"} のような本文を送って注文します。レスポンスのアクティベーションIDを保存します。
3. 返された+994番号を、テスト対象のビルドに入力します。
4. 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セキュリティガイドで解説しています。毎分300リクエストの上限なら、並列ジョブにも十分な余裕があります。

エンジニア以外の人が、+994のコードを手動で取得できますか?

はい。プロダクトマネージャー、翻訳者、サポートリーダーは、画面を確認するためにコードが1つだけ必要なことがよくあります。ダッシュボードなら、APIキーなしでそれを実現できます。

• サインインしてOTP Gatewayを開きます。
• アゼルバイジャンと、テストするサービスを選び、リアルタイムの価格を確認します。
• 番号を注文してアプリに貼り付けます。
• アクティベーションページを開いたままにします。SMSは、配信されるとすぐにそこに表示されます。

テストを取りやめる場合は、アクティベーションをキャンセルすると、金額はすぐにウォレットに戻ります。

バックエンドは+994番号をどう保存・正規化すべきですか?

すべての番号をE.164形式で保存してください。たとえば +994 に9桁の国内番号を続けた形です。国内では事業者コードの前にトランクの 0 をダイヤルするため、登録フォームには両方の形式が届きます。スペース、ハイフン、国内の 0 を取り除いてから、国コードを前に付けて保存します。手書きの正規表現よりも、メンテナンスされた解析ライブラリのほうが安全です。

アゼルバイジャン語は公用語で、ə、ğ、ı、ş、çなどの文字を含むラテン文字を使い、ロシア語も広く通じます。サービスと端末のロケールによって、コードはアゼルバイジャン語、ロシア語、英語のいずれかで届くことがあります。そのため+994のルートは、自社のSMSテンプレートが特殊な文字を正しく表示するか、コードのパーサーが英語の文面に依存していないかを確認するのに便利です。

コードが現れませんでした。エスカレーションの前に何を試すべきですか?

まず、アクティベーションを20分間フルに走らせてください。メッセージをキューに溜めて送る送信元もあります。何も届かなければ、注文は期限切れとなり、activation.expired が発火し、全額が自動的に返金されるので、料金が発生するのはコードが届いたときだけです。

そのうえで、よくある原因を順に確認します。

• フローによっては、仮想番号を拒否するサービスもあります。ルートのせいにする前に、そのサービスが受け付けるかを確認してください。
• 後でもう一度試すか、同じ画面を検証できる別のサービスルートに切り替えます。
• 短い間隔で再注文するのは避けます。試行の間隔を空けて、失敗の連続がキューを消耗させないようにします。

さらなる診断は、配信失敗チェックリストにまとめています。

アゼルバイジャンの長期回線はありますか?利用料金はどう課金されますか?

アゼルバイジャンにはセルフサービスの専用番号はありません。専用番号は米国とカナダ向けの製品で、月額$1.95からです。恒久的な+994回線が必要な場合は [email protected] にメールしてください。チームが現地の規制で何が可能かを確認しますが、提供できる保証はありません。繰り返しのログインが必要なアカウントには、米国またはカナダの回線が代替手段になります。

バクーでのテストの費用は、サブスクリプションのティアも月額料金もない、前払い式のUSDウォレット1つから差し引かれます。カードまたはUSDT/USDCでチャージでき、チャージのたびにPDFの請求書がメールで届きます。最新の料金は料金ページにあります。開発アカウントはリクエストによりサンドボックスに切り替えられ、実際の資金を使う前に、シミュレートされた番号とコードで連携をエンドツーエンドでテストできます。すべての注文に、OTP Routeの利用規定(Acceptable Use Policy)と各サービスの規約が適用されます。

よくある質問

現地のSIMなしで、自社アプリのアゼルバイジャン向け登録フローをテストできますか?

はい。OTP Gatewayで+994番号を注文してアプリに入力すれば、物理SIMなしで、ダッシュボードまたはAPIでコードを読み取れます。

OTP Route APIでのアゼルバイジャンの国IDは何ですか?

POST /api/v1/activations の country フィールドと、価格の照会で az を使います。

テスト用の+994番号はいくらですか?

コードは$0.20/コードからです。正確な金額はサービスによって異なり、確定する前に GET /api/v1/prices で取得できます。

アゼルバイジャンのSMSが届かなかった場合、料金は発生しますか?

いいえ。20分以内にコードが届かない場合、またはその前にキャンセルした場合は、全額がウォレットに自動で返金されます。

アゼルバイジャンの番号は、先頭の0を付けて保存すべきですか?

いいえ。国内のトランク 0 を取り除き、+994 で始まるE.164形式で保存してください。

後のログインのために、同じアゼルバイジャンの認証番号を保持できますか?

OTP Gatewayではできません。1コードにつき1つの番号を発行します。セルフサービスの長期回線は米国とカナダにしかないため、アゼルバイジャンについてはサポートにご相談ください。

アゼルバイジャンの認証メッセージは、どの言語で届きますか?

送信元と端末の設定によります。アゼルバイジャン語、ロシア語、英語のいずれもよくあります。

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