ウズベキスタンのローンチとQAに向けた+998認証コードの自動化

+998のアクティベーションは、リクエストからコードまでどう進みますか?

まず、Developerコンソールでキー(Bearer)を作成します。キーの接頭辞は or_live_ で、すべての呼び出しは https://otproute.com/api/v1 に送られ、最大10個のキーを持てるため、夜間ビルドと手動QAでキーを分けるのに便利です。

クライアントはまず GET /api/v1/countries を読み(ウズベキスタンは uz として載っています)、サービスidのために GET /api/v1/services を読みます。次に GET /api/v1/prices?country=uz&service=<id> で、その組み合わせが今いくらか、番号が利用できるかを尋ねます。答えがテストに合うなら、{"service": "instagram", "country": "uz"} のようなボディで POST /api/v1/activations を送り、アクティベーションidと+998の番号を受け取ります。

次にテストが、その番号をご自身のサインアップまたはログイン画面に入力します。ここからコードは、Webhookイベントとして、または GET /api/v1/activations/{id} を通じて届きます。中断するテストは、予約を解放するために POST /api/v1/activations/{id}/cancel を呼び出す必要があります。実行の冒頭で GET /api/v1/balance を確認すれば、途中で止まるスイートを避けられます。このSMS認証APIのすべてのリクエストは、APIリファレンスに記載されています。

ウズベキスタンのコード向けに、信頼できるWebhook受信側には何が必要ですか?

認証、リプレイ保護、冪等性の3つです。

• 認証。 各配信には、t=<unix>,v1=<hex> の形で X-OTPRoute-Signature が含まれます。<t>.<raw body> という文字列を作り、エンドポイントのシークレットでHMAC-SHA256の署名を計算し、v1 と定数時間で比較します。
• リプレイ保護。 t の値が、ご自身で決めた短い許容範囲より古いリクエストはすべて拒否します。
• 冪等性。 イベントを処理したらアクティベーションidを保存し、重複したものは再び処理せずに受理だけ返します。

正常系には activation.sms_received を購読し、テストランナーが失敗を締められるよう activation.expired と activation.cancelled も購読してください。1アカウントにつき最大5つのエンドポイントを登録でき、たとえば環境ごとに1つとすることができます。ポーリングも有効な代替手段です。1分あたり300リクエストの上限は、数秒おきに確認する複数の同時アクティベーションをまかなえます。より完全なパターンはWebhookによるOTP取得にあります。

チームがOTPルーティング計画にウズベキスタンを加えるのはなぜですか?

ウズベキスタンは中央アジアで最も人口が多い国で、地域全体に展開する企業は、現地パートナーが決まる前に、テスト用の+998番号が必要になることがよくあります。典型的な理由は、ウズベキスタンのユーザーを狙ったプロダクトのローンチ、ウズベク語とロシア語の翻訳のQA、そしてこの市場に関連するベンダーやマーケットプレイスのアカウントを認証する地域の運用チームです。

Telegramはこの国で最も広く使われているメッセージングアプリの一つなので、Telegramアカウントを連携するフローや、サポートにそれを使うフローには、専用のテストが必要です。複数の市場を同時に計画していますか?国別ルーティングガイドでは、テストケースごとにルートを選ぶ方法を説明しています。

+998の番号は、どのようにパース、保存、読み取りをすべきですか?

ウズベキスタンの完全な番号は +998 に9桁が続く形で、そのうち最初の2桁は通常、事業者または地域を示します。国内のダイヤルの習慣は年月とともに変わってきたため、ユーザーは余分な先頭の数字を付けたり、国番号なしで番号を入力したりすることがあります。保存する前に、すべてを+998と9桁に正規化し、+998 90 123 45 67 のような表示用の整形はあくまで見た目だけのものにしてください。

ウズベク語が公用語です。公式にはラテン文字で書かれますが、キリル文字も一般的で、ロシア語も広く通じます。そのため認証テキストは、どちらの文字のウズベク語でも、ロシア語でも、英語でも届く可能性があります。抽出処理はキーワードではなく数字の並びを探すように書き、3つの言語すべてでテストしてください。

ゲートウェイ経由で、ウズベキスタンのSMS OTPを受信できるアプリは?

ウズベキスタンのルートでは、1,800を超えるサービスを利用できます。ライブのスナップショットには、Telegram、WhatsApp、Instagram、Google (Gmail & YouTube)、TikTok、Facebook、Microsoft & Outlook、Amazon、Discord、Snapchat、Signal、Viber、ChatGPT (OpenAI)、Claude、WeChatが載っています。

対応状況は固定ではありません。朝には使えたサービスが、後で使えなくなることもあります。前日の実行結果を前提にせず、実行時に料金エンドポイントで判断してください。

APIなしで、ウズベキスタンの認証用番号を注文できますか?

クリック操作を好む人のために、ダッシュボードはAPIと同じことができます。

1. メールアドレスと届いた6桁のコードでサインアップするか、Googleサインインを使います。アカウントのTOTPを有効にします。
2. ウォレットにチャージします。
3. ウズベキスタンとサービスを選びます。確定する前に料金が表示されます。
4. 確認したいアプリで、+998の番号を使います。
5. 届いたら、アクティベーション画面でコードを読み取ります。

ウズベキスタンのコードが間に合わない場合は?

+998のアクティベーションは20分間有効で、料金はコードが実際に受信されたときにのみ発生します。期限が切れた場合やキャンセルした場合は、サポートへの問い合わせなしで、全額がウォレットに戻ります。

コードが届かない場合は、次のリストを順に確認してください。

• ウィンドウを待ち切ります。配信の速さは、サービスやルートによって異なります。
• 時間をおいて再試行するか、テストが許すなら別のサービスルートを選びます。
• サービスが仮想番号を拒否していないか確認します。拒否するものもあり、返金ルールはそのためにあります。
• 新しい注文を連続して送るのではなく、再試行の間隔をあけ、後で見直せるようにアクティベーションidを記録します。

+998の長期回線と、サンドボックスでの課金は利用できますか?

ウズベキスタンのセルフサービスの長期番号はありません。OTP Routeが専用番号を販売するのはアメリカとカナダのみで、月額$1.95からで、SMS受信、SMS送信、ブラウザ通話が付きます。長く使えるウズベキスタンの回線については [email protected] にメールしてください。手配できるかは現地の規則によるため、確実ではありません。

支払いは、サブスクリプションのない従量課金の、1つのプリペイドUSDウォレットで行います。カードまたはUSDT/USDCでチャージすると、チャージごとにPDFの請求書がメールで届きます。開発用アカウントはサンドボックスモードを依頼でき、番号とコードが模擬されるため、CIはウォレットの残高に触れずに実行できます。

利用は正当な範囲にとどめてください。ご自身のプロダクトをテストおよび運用し、各サービスの規約を守り、OTP Routeの利用規定(Acceptable Use Policy)に従ってください。

よくある質問

ウズベキスタン国外から、アプリのウズベキスタン向けサインアップフローを検証できますか?

はい。OTP Gatewayの+998番号は、チームがどこにいてもコードを受信でき、ダッシュボードまたはAPIで読み取れます。

ウズベキスタンOTP APIで使う国idは何ですか?

料金のクエリと、POST /api/v1/activations のボディで uz を使います。

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

$0.20/コードからです。各サービスには独自のライブ価格があり、GET /api/v1/prices が返し、注文を確定する前に表示されます。

ウズベキスタンのOTPメッセージは、ラテン文字とキリル文字のどちらですか?

どちらもあり得ます。ロシア語や英語で送るサービスもあります。周囲のテキストではなく、数字のコードに一致させてください。

ウズベキスタンのコードが届かない場合、課金されますか?

いいえ。20分後に空のまま期限切れとなったウズベキスタンのアクティベーションや、キャンセルしたものは、何も請求せずに全額がウォレットに返金されます。

ウズベキスタンの番号を、繰り返しのログイン用に保持できますか?

セルフサービスではできません。使い捨て番号は1回分のコードしか扱えません。再ログインが必要なアカウントには、アメリカまたはカナダの専用番号が向いています。ウズベキスタンについてはサポートにメールでお尋ねください。

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