ウクライナ(+380)の認証コードに適したルートを選ぶには

ウクライナのテストケースには、使い捨て番号と長期回線のどちらが必要ですか?

ほかのすべてを左右する問いなので、まずここから始めましょう。使い捨てのOTP Gateway番号は、1回分の認証コードを受け取って閉じます。長期回線は、自分で保持し、数か月後にもう一度ログインするために使うものです。

ウクライナの場合、答えは単純です。セルフサービスで使えるのはOTP Gatewayです。ウクライナの専用番号にセルフサービスのものはありません。長期の専用番号はアメリカとカナダのみで、月額$1.95からです。ログインし続ける必要があるステージングアカウントや、チームで共有するリカバリー用回線に向いています。長く使える+380回線がどうしても必要な場合は、[email protected] にメールでご相談ください。提供可否は現地の規則によるため、お約束はできません。

実際の使い分けとしては、サインアップや電話番号ステップのQAには+380の使い捨て番号を使い、テストアカウントが再認証を乗り越える必要がある場合は、アメリカやカナダの回線がテストに合うか検討してください。トレードオフは一時番号と専用番号の比較記事で順に説明しています。

エンジニアリングチームが+380番号でテストするのはなぜですか?

ウクライナはソフトウェアエンジニアのコミュニティが大きく、海外のプロダクトチームの多くにウクライナ人の開発者やテスターが含まれています。それ以外にも、よく出てくる場面がいくつかあります。

• ウクライナ語のQA:ウクライナ語が国家語であり、オンボーディングをローカライズするチームは、キリル文字の文面に囲まれた実際の電話番号ステップを確認したいと考えます。
• ディアスポラのユーザー:+380の番号を持つ人々は現在ポーランドやドイツなどヨーロッパ各国に住んでおり、別の国で公開したアプリでも、サインアップ時にウクライナの番号に出会います。
• メッセージング中心のフロー:ウクライナではTelegramとViberが広く使われているため、どちらかと連携するプロダクトのテスト対象として一般的です。

認証のテキスト自体は、サービスやアカウントの設定によって、ウクライナ語、英語、その他の言語で届くことがあります。決まった単語に一致させるのではなく、パターンで数字を抽出してください。

+380の番号はどのように正規化すべきですか?

国内では、ウクライナの番号は先頭にトランクの 0 を付け、その後に9桁が続く、0XX XXX XX XX のような形で書かれます。国際形式では0が省かれ、+380 に9桁の国内番号が続きます。国番号そのものが0で終わるため、手書きの検証処理が混乱することがある点にご注意ください。

ガイドラインは次のとおりです。

• 保存するのはE.164の文字列だけにして、スペースやトランクの0を付けた整形は、表示時に行います。
• +380を選んだ後でユーザーが 0… と入力した場合は、先頭の0をちょうど1つだけ取り除きます。
• +3800… に注意してください。これは、トランク接頭辞が取り除かれていないしるしです。
• 長さの検証は、よそからコピーした正規表現ではなく、メンテナンスされているライブラリで行います。

ウクライナの認証用番号では、どのサービスを受信できますか?

ライブのスナップショットでは、ウクライナで1,500を超えるサービスが数えられています。人気のものには、Telegram、Viber、WhatsApp、Signal、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、Discord、LinkedIn、Microsoft & Outlook、Uber、ChatGPT (OpenAI)、Claudeがあります。

提供されるものは一日の中で変わるため、これは例として捉え、現在利用できるものはAPIで確認してください。

ウクライナ OTP APIの呼び出しは、どうつながりますか?

+380番号のリクエストは https://otproute.com/api/v1 に送り、Developerコンソールで生成した or_live_ のBearerキーで署名します。ウクライナの国idは ua です。

きれいな手順は次のとおりです。GET /api/v1/services と GET /api/v1/countries でidを調べ、GET /api/v1/prices?country=ua&service=<id> から料金と利用可否を読み取り、GET /api/v1/balance で残高を確認してから、{"service": "viber", "country": "ua"} を付けて POST /api/v1/activations を送ります。レスポンスには、+380の番号とアクティベーションidが含まれます。

配信については、GET /api/v1/activations/{id} のポーリングか、activation.sms_received、activation.expired、activation.cancelled を購読するWebhookのどちらかを選びます。すべてのWebhookには X-OTPRoute-Signature: t=<unix>,v1=<hex> が付きます。エンドポイントのシークレットで <t>.<raw body> に対するHMAC-SHA256として検証し、古いタイムスタンプは拒否し、各アクティベーションidは1回だけ処理してください。アカウントでは、キー10個、エンドポイント5つ、1分あたり300リクエストまで使えます。詳しくはドキュメントをご覧ください。

開発者でない人のためのダッシュボードの手順は?

サポートやグロースの担当者は、APIをまったく使わずに済みます。ダッシュボードでOTP Gatewayを開き、ウクライナとサービスを選んで、表示された料金を確認して注文します。+380の番号をアプリに入力してSMSをリクエストすると、届いた時点でアクティベーションのページにコードが表示されます。

コードが届かない場合はどうなりますか?請求はどうなっていますか?

アクティベーションは20分間開いたままで、料金はコードが届いたときにのみ発生します。ウィンドウが空のまま閉じた場合や、POST /api/v1/activations/{id}/cancel を呼び出した場合は、全額がウォレットに戻ります。

コードが届かないときは、ウィンドウが終わるまで待ってから、時間をおくか別のサービスルートで再試行します。サービスが仮想番号を拒否していないか確認し、連続して繰り返し注文しないでください。

資金は、月額料金のない1つのプリペイドUSDウォレットから使われます。チャージはカードとUSDT/USDCのどちらでも可能で、そのたびにPDFの請求書が受信トレイに届きます。リクエストに応じて、開発用アカウントを模擬の番号とコードを使うサンドボックスモードで動かせます。CIパイプラインを組むときに便利です。OTP Routeはご自身の正当なプロダクトとアカウントのためのものです。各サービスの規約と利用規定(Acceptable Use Policy)に従ってください。

よくある質問

ウクライナのSIMなしで、ウクライナのSMS OTPコードを受信できますか?

はい。OTP Gatewayで+380の番号を注文し、ダッシュボードまたはAPIでコードを読み取ります。

OTP Routeはウクライナにどの国idを使いますか?

料金の問い合わせと、POST /api/v1/activations のボディで ua を使います。

トランクの0は+380の番号に含まれますか?

国内ダイヤルでのみです。E.164では、+380 に9桁を続けた形で保存し、余分な0は付けません。

ウクライナの認証用番号はいくらですか?

料金は$0.20/コードからで、サービスごとの正確なライブ価格はAPIが返します。

+380の番号を、後のログインのために保持できますか?

ウクライナの長期回線にセルフサービスのものはありません。専用番号はアメリカとカナダ向けの製品です。それ以外については [email protected] にメールでお尋ねください。

Telegramがコードを送ってこなかった場合、お金を失いますか?

いいえ。20分のウィンドウ内にコードが届かなければ、料金は自動的にウォレットに戻ります。

ウクライナ語のオンボーディングを、CIでエンドツーエンドにテストできますか?

はい。テストスイートからAPIを呼び出せば可能で、サンドボックスアカウントなら、先に模擬のコードでフローをリハーサルできます。

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