エストニアの+372認証コードを受信するための事前チェックリスト

最初の+372注文の前に、チェックリストに入れておくべきことは?

失敗するテスト実行の多くは、番号を要求する前の準備不足に行き着きます。まず次の項目を確認してください。

• APIキー:Developerコンソールで作成します。キーはすべて or_live_ で始まり、Bearerトークンとして送ります。1アカウントに10個まで持てるので、CIランナー専用のキーを用意しておくと安心です。
• Webhookエンドポイント:ポーリングより通知を受けたい場合に使います。シークレットはサーバー側に保管してください。1アカウントで5つまで利用できます。
• 正しいID:エストニアはすべてのリクエストで ee です。サービスIDは GET /api/v1/services から取得します。
• リアルタイムの価格確認:GET /api/v1/prices?country=ee&service=<id> を呼び、ウォレットの資金を確保する前にジョブが費用を把握できるようにします。
• まだ連携を組んでいる最中ならサンドボックス:ご依頼により、開発用アカウントをサンドボックスモードに切り替えられます。残高に触れずに、シミュレートされた番号とコードがエンドツーエンドで返ります。
• レート予算:APIはアカウントあたり毎分300リクエストまで受け付けます。テストスイートが無頓着にポーリングしない限り、十分な枠です。

それぞれの項目は、OTP API連携ガイドでさらに詳しく解説しています。

エストニアのOTP APIリクエストを最初から最後まで実行するには?

チェックリストが済めば、呼び出しの順序は短く済みます。

1. POST /api/v1/activations に本文 {"service": "<id>", "country": "ee"} を送ります。レスポンスには、アクティベーションIDと、テスト対象の登録・ログインフォームに入力する+372番号が含まれます。
2. テスト対象のアプリから認証SMSを送信させます。
3. コードを待ちます。エンドポイントが activation.sms_received を受信するか、GET /api/v1/activations/{id} を適度な間隔で呼び出します。
4. アプリにコードを入力し、結果をアクティベーションIDに紐づけて記録します。
5. テストの経路が変わって番号が不要になったら、POST /api/v1/activations/{id}/cancel を呼んで、確保をすぐに解除します。

Webhookの配信では、X-OTPRoute-Signature ヘッダー(t=<unix>,v1=<hex>)を読み取り、エンドポイントのシークレットで <t>.<raw body> のHMAC-SHA256を計算します。比較は定数時間で行い、古いタイムスタンプのものは破棄してください。参考実装のハンドラーは、HMACによるOTP Webhookの保護で順を追って紹介しています。再送で同じイベントが2回届くことがあるため、書き込みはアクティベーションIDで冪等にしてください。

エストニアの認証番号にコードを送れるサービスは?

エストニアの現在のスナップショットでは、1,700を超えるサービスが掲載されています。人気のルートには、WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、LinkedIn、Microsoft & Outlook、Amazon、Discord、Signal、Uber、Airbnb、ChatGPT (OpenAI)などがあります。

在庫は一日の中で動くため、午前中に応答したルートが夕方には細っていることもあります。テスト用フィクスチャに一覧を固定で書き込むのではなく、GET /api/v1/countries と価格エンドポイントを正確な情報源として扱ってください。

+372番号はどのように保存・検証すべき?

エストニアは最も扱いやすい番号体系のひとつですが、だからこそ手抜きの入力検証が破綻しがちです。取り除くべきトランクプレフィックスはありません。国内で書かれた番号は、+372の後ろにそのまま付く桁と同じです。携帯番号は通常5で始まり、7桁または8桁なので、国内桁数を固定で要求する正規表現は、有効な入力を弾いてしまいます。

フォームとデータベースの実践的なルールは次のとおりです。

• +3725xxxxxxx のようなE.164の完全な文字列を保存し、サポート用に必要なら、ユーザーの生の入力は別に保持します。
• 先頭に0を付け足さないでください。取り除くものも、足すものもありません。
• 入力マスクで、7桁と8桁の両方の携帯番号をテストします。

エストニアのユーザー向けの認証テキストは通常エストニア語で届きますが、多くのアプリはアカウントや端末の言語に従い、ロシア語や英語のテンプレートもよく使われます。自社プロダクトにエストニア語ロケールがある場合は、õ、ä、ö、üといった文字が、テンプレートから端末まで崩れずに届くかを確認してください。

エストニアの番号でサインアップのフローをテストするチームがあるのはなぜ?

エストニアは、ソフトウェアチームにとって、国の規模以上の存在感があります。電子政府という評判とe-Residencyプログラムのおかげで、スタッフが他国に住んでいても、この国と関わりを持つ創業者やリモート企業が多く、バルト・北欧地域を狙うプロダクトが最初に立ち上げる市場になることもよくあります。

QAリードが+372番号をテスト用に求める典型的な理由は次のとおりです。

• 番号体系の短いEU市場で、国選択、電話番号マスク、SMSテンプレートが正しく動作することを確認する。
• 地域リリースの前に、エストニア語の文面のローカライズを確認する。
• コードが届かなかったエストニアの顧客からの問い合わせチケットを再現する。

こうしたチェックをチームがリリースサイクルに組み込む方法は、QAテストをご覧ください。

コードが届かないときは何を確認すべき?

番号を次々に注文するのではなく、順番に問題を切り分けてください。

1. 有効時間を最後まで待つ:アクティベーションは20分間開いており、サービスによってはテキストをキューに入れます。
2. サービスが仮想番号を受け付けるか確認する:ポリシーで拒否するサービスもあります。返金ルールはそのためにあります。
3. 最終ステータスを見る:activation.expired イベントや、GET呼び出しで期限切れの状態が返った場合は、SMSが届かなかったことを意味し、代金はすでにウォレットに戻っています。
4. 余裕を持って再試行する:短い間隔で再注文するのではなく、少し待ってからもう一度試すか、同じサービスの別ルートを試します。
5. 自分側のトリガーを確認する:SMSを実際には要求していないテストは、コードが届かないケースと見分けがつきません。

ほかに除外しておきたい原因は、OTP配信失敗を減らすの記事にまとめています。

エストニアの回線を長期で維持できる? 課金の仕組みは?

セルフサービスの長期エストニア番号はありません。専用番号は米国・カナダ向けの製品で、月額$1.95からです。エストニアで継続的な回線が必要な場合は [email protected] にメールしてください。現地の規制で何が可能かをチームがお伝えしますが、提供できるとは約束できません。

OTPルーティングの課金は、月額料金もプランの選択もない、前払いのUSDウォレット1つで行われます。カードまたはUSDT/USDCで入金でき、入金のたびにPDFの請求書がメールで届きます。現在の料金は料金ページに、エンドポイントのリファレンスはドキュメントにあります。

よくある質問

現地のSIMなしで、自社アプリのエストニア向け登録フローをテストできますか?

はい。OTP Gatewayで+372番号を注文し、登録フォームに入力して、ダッシュボード、Webhook、またはアクティベーションのエンドポイントからコードを読み取ります。

OTP Route APIでのエストニアの国IDは何ですか?

アクティベーションと価格のリクエストの country 値には ee を使います。

エストニアの電話番号には、取り除くべきトランクプレフィックスがありますか?

いいえ。エストニアにはトランクプレフィックスがないため、国内の桁がそのまま+372の後ろに続きます。

エストニアのコードが届かなかった場合、課金されますか?

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

開発者でなくても、エストニアの認証用番号を注文できますか?

はい。ダッシュボードでエストニアとサービスを選び、表示された価格を確認して、番号をアプリにコピーすれば、同じ画面にコードが表示されるのを待つだけです。

実際の資金を使う前に、エストニア向けの連携を試せますか?

サポートに依頼して開発用アカウントをサンドボックスに切り替えてもらうと、シミュレートされた番号とコードが返るため、ウォレットの資金なしで全フローを実行できます。

これらの番号の利用にはどのようなルールが適用されますか?

各サービスの利用規約とOTP RouteのAcceptable Use Policyに従ってください。番号は、自社の正当なプロダクトとアカウントのテストおよび運用のためのものです。

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