カザフスタン(+7)の認証コードをテストスイートに組み込む

カザフスタンのOTP実行で使うエンドポイントは?

1サイクルは、https://otproute.com/api/v1 に対する5〜6回のリクエストで、or_live_ で始まるBearerキーで署名します。カザフスタンの国IDは kz で、1アカウントに最大10個のキーを持てるため、CI、ステージング、開発者のノートPCがそれぞれ専用のキーを使えます。

• ジョブの冒頭で GET /api/v1/balance を呼び、ウォレットが空なら実行を早めに失敗させます。
• GET /api/v1/prices?country=kz&service=telegram で、その組み合わせの現在の価格と利用可否を読み取ります。
• {"service": "telegram", "country": "kz"} を本文にして POST /api/v1/activations を送ると、アクティベーションIDと+7番号が返ります。
• ポーリングする場合は GET /api/v1/activations/{id} を呼びます。Webhookを使うなら何も呼びません。
• コードが必要になる前にテストが終了した場合は、POST /api/v1/activations/{id}/cancel を呼びます。

上限はアカウントあたり毎分300リクエストで、数秒おきにポーリングする並列ジョブにも余裕があります。初めて構築する場合は、API連携ガイドから始めてください。

ポーリングではなくWebhookで+7のコードを受け取るには?

Developerコンソールでエンドポイントを登録し(アカウントあたり5つ)、activation.sms_received、activation.expired、activation.cancelled を購読します。各POSTには X-OTPRoute-Signature: t=<unix>,v1=<hex> が付きます。

エンドポイントのシークレットで <t>.<raw body> のHMAC-SHA256を再計算し、定数時間で比較してください。受信したままの生のバイト列を使うこと。JSONを再シリアライズするとダイジェストが変わります。また、リプレイを防ぐため、短い許容範囲を外れたタイムスタンプは拒否します。配信は再試行されることがあるため、アクティベーションIDでupsertし、2通目では何も変わらないようにします。手順はWebhookによる認証コードの取得で順を追って解説しています。

カザフスタンの番号にコードを送れるアプリは?

kz のルートには1,700を超えるサービスが一覧にあります。最新のスナップショットで人気のものには、Telegram、WhatsApp、Google (Gmail & YouTube)、Instagram、TikTok、Facebook、Viber、Discord、Microsoft & Outlook、LinkedIn、Uber、AliExpress、Amazonがあります。

その一覧をコードに固定しないでください。ルートは一日の中で変わるため、スクリプトは注文のたびに GET /api/v1/prices を確認し、ある組み合わせが使えない場合は、代替のサービスIDを選ぶようにします。

電話番号データベースで+7に特別な注意が必要なのはなぜ?

カザフスタンは国番号7をロシアと共有しています。どちらも10桁の国内番号を使い、カザフスタンの携帯番号の範囲は通常、+7の後ろが7で始まります。+7 7xx xxx xx xx のような番号はカザフスタンのもので、ロシアの携帯の多くは9から始まります。ダイヤルコードだけから国を推定してはいけません。メンテナンスされている電話番号ライブラリで番号の範囲から国を判定するか、国を示すフィールドを別に持たせてください。

国内では、10桁の前にトランクの8をダイヤルします。入力時にそれを取り除き、E.164形式、つまり +7 に国内番号を続けた形で保存してください。カザフ語は国語で、ロシア語も公的に広く使われているため、認証テキストはロシア語、カザフ語、英語のいずれかで届くことがあり、通常はキリル文字です。SMSパーサーとログがUTF-8を扱えること、そして文面ではなく数字を抽出することを確認してください。

チームがここでテストするのは、中央アジアでのローンチ、バイリンガルのローカライズの確認、現地の運用担当者のサポートなどの場面です。

コードを書かないチーム向けのダッシュボードの経路はある?

あります。メールコードまたはGoogleで新規登録したら、ウォレットにチャージし、カザフスタンとサービスを選び、表示された価格を確認して注文します。+7番号と、その後に届くコードが、アクティベーションのカードに表示されます。プロダクトマネージャーやローカライズのテスター担当者は、ボリュームをパイプラインに任せつつ、スポットチェックにこれを使っています。

カザフスタンの番号を繰り返しのログインのために保持できる?

セルフサービスではできません。OTP Gatewayの番号は1回のコード専用で、長期のDedicated Numbersは米国とカナダでのみ販売されており、月額$1.95から、受信・送信SMSとブラウザ通話が含まれます。長期のカザフスタンの回線が必要なら、[email protected] にメールしてください。手配できるかどうかは現地の規制次第で、確実ではありません。再度サインインが必要なステージングアカウントには、サービスが受け付ける場合、米国またはカナダの回線が現実的な答えになることが多いです。

20分以内にコードが届かなかった場合は?

アクティベーションは期限切れとなり、Webhookで activation.expired が発火し、全額が何もしなくてもウォレットに戻ります。再試行する前に、原因を確認してください。

• 番号は、国内の8ではなく +7 で送信しましたか?
• そのサービスは仮想番号を拒否していませんか?拒否するサービスもあり、OTP Routeが未使用のアクティベーションを返金するのはそのためです。
• すぐにループで再試行するのではなく、時間をおくか別のルートで再試行してください。短いバックオフを入れると、ログが読みやすくなります。

配信速度はサービスとルートによって異なるため、テストでは厳しいタイムアウトを避けてください。

アカウントの課金はどうなる?

前払いのUSDウォレットが1つで、従量課金、サブスクリプションもプランの階層もありません。カードまたはUSDT・USDCのステーブルコインでチャージでき、チャージと番号の購入のたびにPDFの請求書がメールで届きます。開発アカウントは、リクエストによりサンドボックスに切り替えられ、エンドツーエンドのテスト用に模擬の番号とコードが返されます。サービスはご自身の正当なプロダクトにのみ使用し、各アプリの規約と利用規定(Acceptable Use Policy)を守ってください。最新のレートは料金をご覧ください。

よくある質問

カザフスタンの+7番号とロシアの番号はどう見分ける?

国番号だけでなく、番号の範囲を見てください。カザフスタンの携帯は通常、+7の後ろが7で始まります。メンテナンスされている電話番号ライブラリか、国を示すフィールドを別に持てば、間違いを防げます。

OTP Route APIでのカザフスタンの国IDは?

アクティベーションの本文と、価格エンドポイントの country パラメータで kz を使います。

現地のSIMなしで、カザフスタンのサインアップフローをテストできる?

はい。OTP Gatewayでカザフスタンの+7番号を注文し、自社のフローに入力して、コードをWebhook、ポーリング、ダッシュボードのいずれかで取得します。

Telegramのコードが届かなかった場合、課金される?

いいえ。20分の有効時間内にSMSが届かなかった場合、またはキャンセルした場合は、金額が自動的にウォレットに戻ります。

カザフスタンの認証テキストはロシア語かカザフ語で届く?

どちらもあり得ますし、英語を使うサービスもあります。数字のコードを解析し、スタックがキリル文字のテキストを扱えることを確認してください。

カザフスタンのルートに月額料金はある?

いいえ。OTP Routeは、カード、USDT、USDCでチャージする前払いUSDウォレットによる従量課金です。

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