カタールOTP API:Webhook、ポーリング、+974テスト番号

カタールOTP APIの呼び出し手順はどうなっていますか?

すべては https://otproute.com/api/v1 の下にあり、or_live_ で始まるBearerキーで認証します。キーは最大10個持てるので、CI、ステージング、運用スクリプトにそれぞれ別のキーを割り当てれば、他に影響を与えずに1つだけ無効化できます。+974のアクティベーションは、多くても4回の呼び出しで完了します。

1. GET /api/v1/prices?country=qa&service=<id> が現在の価格を返し、そのサービスのルートが今開いていることを示します。
2. POST /api/v1/activations に {"service": "<id>", "country": "qa"} を送ると、カタールの番号が確保され、アクティベーションIDが返ります。
3. GET /api/v1/activations/{id} がポーリング用の呼び出しです。カタールの注文の状況が分かり、配信後はコードも含まれます。
4. POST /api/v1/activations/{id}/cancel は注文を途中で終了し、金額をウォレットに戻します。

あと2つ補助的なAPIがあります。GET /api/v1/services はサービス名をサービスIDに対応付け、GET /api/v1/balance は残高が尽きる前にパイプラインを止めるのに使えます。トラフィックは、アカウントあたり毎分300リクエスト以内に抑えてください。リファレンスは開発者向け概要にまとめてあります。

Webhookハンドラーは、カタールのアクティベーションイベントをどう扱うべきですか?

ポーリングでも動きますが、Webhookなら、何かが起きた瞬間にテストランナーが反応できます。最大5つのエンドポイントを登録し、activation.sms_received、activation.expired、activation.cancelled を購読してください。最初のイベントがコードを運び、残り2つはランナーに待機をやめるよう伝えます。

各リクエストには、t=<unix>,v1=<hex> の形式で X-OTPRoute-Signature が含まれます。署名対象の文字列は、タイムスタンプ、ドット、生のリクエストボディをこの順につなげたものです。エンドポイントのシークレットでHMAC-SHA256を計算し、定数時間で比較してください。タイムスタンプが古いものは拒否します。再試行によって同じイベントが複数回届くことがあるため、アクティベーションIDを保存し、重複は無視してください。参考実装はWebhookベースのコード取得で読めます。

+974番号にコードを届けられるサービスは?

カタールは対応範囲の広いルートの1つで、最新のスナップショットでは1,600を超えるサービスが利用できます。よく使われるものには、WhatsApp、Google (Gmail & YouTube)、Microsoft & Outlook、Telegram、Instagram、Facebook、LinkedIn、Snapchat、TikTok、Uber、Airbnb、ChatGPT (OpenAI)、Claude、Discordがあります。

在庫は1日の中で変動するため、スナップショットは目安にとどめ、実際の判断はAPIの答えに従ってください。仮想番号を拒否するサービスもあり、その場合は注文がそのまま期限切れになり、代金は戻ります。上に挙げた名前はそれぞれの所有者の商標であり、提携関係を示すものではありません。

テストデータでカタールの番号を正規化するには?

カタールの番号は、+974の後に8桁が続き、国内プレフィックスはありません。そのため、国内番号を国際形式に変換するときに取り除くものはありません。フィクスチャはE.164(+974 に8桁)で保持し、ユーザーが 00974、スペース、他の国の習慣で付けた余分な先頭の0つきで入力した場合は、整えてください。

公用語はアラビア語で、ビジネスでは英語も広く使われ、人口に占める外国人居住者の割合も大きい国です。そのため認証SMSは、送信元サービスがアカウントに合わせて選んだ言語、多くは英語かアラビア語で届きます。抽出ロジックが両方の文字でコードを見つけられるか、そしてアラビア語UIで右から左へのレイアウトでもOTP入力欄が使いやすいかを確認してください。

カタールのルートをテストするのは、GCCに展開するとき、アラビア語話者向けにコンシューマーアプリをローカライズするとき、ドーハで宿泊業や物流の業務を運営するとき、社員の個人番号を使わずに地域のビジネスアカウントを認証するときなどです。CIテストガイドでは、これらの確認を自動実行に組み込む方法を紹介しています。

代わりにダッシュボードでカタールを確認するには?

すべての認証にスクリプトが必要なわけではありません。ダッシュボードでOTP Gatewayを開き、カタールとサービスを選び、表示された価格を確認して確定します。+974の番号をアプリにコピーし、SMSを要求すると、注文の画面にコードが表示されます。20分の有効時間は注文した瞬間から始まり、課金されるのはコードが届いたときだけです。

コードが届かないときのデバッグチェックリスト

• 十分に待ちましたか? 失敗と判断する前に、アクティベーションの有効時間いっぱいまで待ってください。
• 仮想番号は受け付けられていますか? ブロックするサービスもあり、何度試しても変わりません。
• 再試行の方針は適切ですか? 間隔をあけて後で再試行するか、同じサービスの別のルートに切り替えます。短い間隔での再注文はレート制限を無駄にし、ほとんど効果がありません。
• ハンドラーは正常ですか? 署名チェックが失敗したり、エンドポイントがエラーを返したりしている場合は、GET /api/v1/activations/{id} をポーリングして、Webhookを取り逃している間にコードが届いていないか確認してください。

SMSが届かずに終了したアクティベーションは、期限切れでもキャンセルでも、全額返金されます。

カタールの長期回線はありますか?利用料金はどう請求されますか?

カタールには、セルフサービスの長期番号はありません。Dedicated Virtual Numbers(送受信SMS、Webhook転送、ブラウザ通話に対応した専用回線)は、米国とカナダのみで、月額$1.95からです。カタール固有のニーズについては、[email protected] までメールしてください。可能かどうかは現地の規則次第です。

カタールの利用料金は、1つのプリペイドUSDウォレットから差し引かれ、月額課金はありません。カードまたはUSDT/USDCでチャージでき、チャージごとにPDFの請求書を受け取れます。シミュレートされた番号で連携をテストしたい場合は、開発アカウントのサンドボックスモードを依頼できます。+974番号は、自社の製品と正当なビジネスアカウントにのみ使用し、各サービスの利用規約を守り、OTP Routeの利用規定(Acceptable Use Policy)に従ってください。

よくある質問

自動テストでカタールのSMS OTPコードを受信するには?

国 qa でアクティベーションを作成し、返された番号をテスト対象のアプリに入力して、activation.sms_received のWebhookを待ちます。テストランナーが受信リクエストを受け付けられない場合は、OTP Routeはアクティベーションのポーリングにも対応しています。

カタールのSIMがなくても、+974番号でテストできますか?

はい。OTP Gatewayは1つのコード用にカタールの認証用番号を提供するため、現地のSIMや端末がなくても、サインアップやログインのフローをテストできます。

注文前にカタールの価格を確認するには?

GET /api/v1/prices?country=qa&service=<id> を呼び出すか、ダッシュボードで確認します。料金は1コード$0.20からで、サービスによって異なります。

失敗したカタールのアクティベーションにも課金されますか?

いいえ。課金されるのはコードが届いたときだけです。期限切れまたはキャンセルされたアクティベーションは、自動的にウォレットへ返金されます。

近隣の国の番号ではなく、カタールの番号でテストするのはなぜですか?

アカウントの実際の市場に合った国を選んでください。カタールで製品を展開するなら、+974番号なら、顧客が実際に目にする国番号の処理、言語、OTPルーティングをそのまま確認できます。詳しくはOTPの国別ルーティングをご覧ください。

開発アカウントは、ウォレットの資金なしで動かせますか?

はい。リクエストに応じて、開発アカウントをサンドボックスに切り替えられ、エンドツーエンドのテスト用にシミュレートされた番号とコードが返ります。

繰り返しのログイン用に、カタールの番号を保持できますか?

専用回線は米国とカナダに限られるため、セルフサービスでは提供していません。カタールの長期回線について知りたい場合は、[email protected] にメールしてください。

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