OTPルーティングAPIでフィンランド(+358)のSMS認証をテストする

現時点で+358番号により認証できるサービスは?

フィンランドのルートは現在、2,800を超えるサービスを掲載しています。チームから特によく問い合わせがあるものには、WhatsApp、Signal、Telegram、Google (Gmail & YouTube)、Microsoft & Outlook、LinkedIn、Discord、Uber、Amazon、ChatGPT (OpenAI)、Claude、Netflix、Airbnbがあります。

この一覧は約束ではなくスナップショットとして扱ってください。各ルートの利用可否は一日の中で動くため、GET /api/v1/prices は、静的なページから推測させるのではなく、価格と一緒にリアルタイムで報告します。

フィンランドのOTP APIはどのような手順で動く?

すべては https://otproute.com/api/v1 に対して、Developerコンソールで作成した or_live_ で始まる Bearer キーで実行されます。フィンランドの国IDは fi です。

1. GET /api/v1/services でサービスIDを一度調べ、GET /api/v1/countries で fi を確認します。
2. GET /api/v1/prices?country=fi&service=<id> で、現在の価格と利用可否を確認します。
3. {"service": "signal", "country": "fi"} のような本文で POST /api/v1/activations を送って注文します。レスポンスには、アクティベーションIDと+358番号が含まれます。
4. テストしているアプリの登録またはログイン画面に、その番号を入力します。
5. そのアクティベーションの activation.sms_received をWebhookで受け取るか、代わりに GET /api/v1/activations/{id} をポーリングします。止まってしまった実行は、POST /api/v1/activations/{id}/cancel で中止します。

すべてのフィールドはAPIリファレンスに記載されており、アカウントの上限である毎分300リクエストは、ポーリングに十分な余裕があります。

フィンランドの電話番号は、どう保存・正規化すべき?

フィンランドでは、携帯番号を先頭のトランクの 0 を付けて書くため、国内の番号は通常 04 や 050 で始まります。E.164ではそのゼロが消え、保存される値は +358 に残りの桁を続けた形、たとえば +358040… ではなく +35840… になります。フィンランドの番号の長さは一定ではないため、固定の桁数ではなく、libphonenumberのようなライブラリで検証してください。

フィンランドの公用語は、フィンランド語とスウェーデン語の2つで、多くのアプリは英語も提供しています。コードの前後の文面は、一般にアプリ自身のロケール設定に従うため、3言語すべてでローカライズの確認を行う価値があります。チームが+358番号をテストに使うのは、北欧向けプロダクトを立ち上げるとき、フィンランド語とスウェーデン語のSMSテンプレートを確認するとき、あるいはヘルシンキやトゥルクの顧客から報告されたログインのバグを再現するときです。

ノーコードでフィンランドの認証用番号を取得する方法は?

はい、あります。アカウントを作成した後は、サポート、グロース、運用の担当者がダッシュボードだけで作業できます。

• フィンランドと、必要なサービスを選びます。
• 注文前に表示された価格を確認してから、確定します。
• +358番号を、アプリの認証ステップにコピーします。
• アクティベーションカードを見守ります。コードが届くと、そこに表示されます。

何も届かなかった場合は、20分の有効時間が終了した時点で、またキャンセルすればすぐに、全額がウォレットに戻ります。

チームでフィンランドの長期回線を保持できる?

セルフサービスの製品としてはありません。更新しながら維持する回線である専用バーチャル番号は、米国とカナダのみで販売されており、月額$1.95から、受信・送信SMSとブラウザ通話に対応しています。フィンランドでは、OTP Gatewayは番号1つにつき1回のコードを扱います。継続的な+358回線が必要な場合は [email protected] にメールしてください。チームが現地の規制で何が可能かを確認しますが、手配できるとはお約束できません。テストにどちらのモデルが必要かは、一時番号と専用番号の違いのガイドが判断の助けになります。

+358のテストの支払いはどう行われる?

前払いのUSDウォレットが1つあり、月額料金やプランはありません。カードまたはUSDT/USDCステーブルコインで入金でき、入金のたびにPDFの請求書がメールで届きます。現在の料金は料金ページにあります。フィンランドをCIに組み込む前に、開発用アカウントのサンドボックスへの切り替えを依頼してください。シミュレートされた番号とコードが返るので、ウォレットの資金に触れずにフロー全体を実行できます。サンドボックスでの実行が通ったら、同じコードを本番キーに切り替え、各スイートの開始時に GET /api/v1/balance を確認すれば、北欧向けの回帰テストの途中で失敗するのではなく、パイプラインを早めに止められます。

よくある質問

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

はい。OTP Gatewayでサービス用の+358番号を注文し、自社の登録フォームに入力して、ダッシュボードまたはAPIでコードを読み取ります。

フィンランドの番号をフォームに入力するとき、先頭の0は含めるべきですか?

フォームが国内形式を期待している場合のみです。国際形式では0を省き、+358に残りを続けて書きます。これは、保存するうえでも最も安全な方法です。

認証テキストはフィンランド語とスウェーデン語のどちらで届きますか?

送信元アプリと、アカウントに設定された言語によります。多くのサービスは英語が既定なので、ローカライズする場合は3言語すべてでテンプレートを確認してください。

フィンランドの番号にコードが届かない場合はどうすべきですか?

返金が発動するよう20分の有効時間を最後まで待ち、その後少し時間を置いて再試行するか、別のサービスルートを選びます。一部のサービスは仮想番号を拒否すること、また新しい注文を立て続けに出しても結果が変わることはまれであることにご注意ください。

フィンランドのアクティベーションのWebhookは、どう検証しますか?

エンドポイントのシークレットで <t>.<raw body> のHMAC-SHA256を計算し、X-OTPRoute-Signature の v1 の値と比較して、古いタイムスタンプは拒否します。手順はOTP Webhookの保護の記事で順に解説しています。

OTP Routeは、フィンランドのすべてのサービスが番号を受け付けると約束していますか?

いいえ。どの番号を受け付けるかは各サービスが決めるため、何も保証されません。この不確実性があるからこそ、未使用のアクティベーションは自動的に返金されます。

+358のルートでは、いくつのサービスを認証できますか?

現時点で2,800を超えますが、在庫の変化に応じて数は動きます。テスト実行の前に、APIまたはダッシュボードで最新の一覧を確認してください。

フィンランドの番号の利用ルールはありますか?

自社のプロダクトと正当な業務アカウントにのみ使い、各サービスの利用規約とOTP RouteのAcceptable Use Policyに従ってください。アカウントの大量作成は認められません。

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