日本語
QAチームとバルト地域ローンチのためのラトビア（+371）認証番号
OTP Routeなら、ラトビア（+371）のSMS認証コードをOTP Gatewayの使い捨て番号で受信でき、コードはダッシュボードに表示されるほか、RESTポーリングや署名付きWebhookで自社システムへ送られます。料金は$0.20/コードからで、20分以内にSMSが届かなかった注文はウォレットに返金されます。
ラトビアの電話番号は検証しやすいのはなぜか？
ラトビアはクローズドな番号計画を採用しているので、取り除くべきトランクプレフィックスがありません。加入者番号は8桁で、携帯番号は2で始まります。したがってラトビアの携帯番号のE.164は、+371に2で始まる8桁を続けた形で、国内でも海外でも同じ書き方になります。
そのため検証ルールは短くなります。先頭に付いた+371または00371は許容し、スペースを除去して、ちょうど8桁であることを確認するだけです。先頭が0なら、入力ミスか他国の番号の貼り付けを疑うべきで、黙って削らずにフラグを立てましょう。
公用語はラトビア語ですが、ロシア語も広く話されているため、アプリは両方のロケールを用意していることがよくあります。認証SMSは、サービスやアカウントの設定によって、ラトビア語、ロシア語、英語のいずれかで届きます。文言の一致ではなく、数字を抽出してください。
+371番号でテストや運用をするのは誰か？
ラトビアはエストニアとリトアニアの間に位置し、多くの企業がバルト三国を1つのローンチの波として扱っています。テスト用の+371番号が必要になる典型的な理由は次のとおりです。
- サインアップフォームが8桁のラトビアの携帯番号を受け付け、正しく整形するかを確認する。
- オンボーディング画面やSMSテンプレートの、ラトビア語とロシア語の翻訳を確認する。
- リガにある地域のサポートや運用チームが、社員の電話を使わずに業務用アカウントを認証する。
- EU加盟国ごとにリリース前の確認を行う、EU向け製品のローンチ。
ラトビアでは使い捨て番号と専用回線のどちらが必要か？
ラトビアでは、OTP Gatewayが答えになります。1つのコードだけを受信する、使い捨ての+371番号です。サインアップやログインの確認、自動回帰テストの実行、単発のアカウント確認をカバーします。
OTP RouteのDedicated Numbers（受信と送信のSMS、ブラウザ通話に対応し、継続して保有できる回線で、$1.95/月から）は、米国とカナダでのみ利用できます。セルフサービスで使えるラトビアの長期番号はありません。必要な場合は、[email protected]までご連絡ください。可能かどうかは現地の規則によるため、チームがお答えします。
ラトビアの認証番号で使えるサービスは？
現在のスナップショットでは、+371のルートで1,600を超えるサービスが利用できます。よくリクエストされるものとして、WhatsApp、Telegram、Google（Gmail＆YouTube）、Facebook、Instagram、TikTok、X（Twitter）、LinkedIn、Microsoft＆Outlook、Amazon、Discord、Viber、Uber、Airbnbがあります。
ルートは継続的に更新されるため、今日掲載されているサービスが、あとで一時的に使えなくなることもあります。可用性は固定で書かず、実行時に確認してください。
ラトビアのOTP APIを段階的に呼び出すには
ラトビア向けのテストはhttps://otproute.com/api/v1と通信し、開発者コンソールで発行したor_live_のBearerキーで各リクエストに署名します。ラトビアの国IDはlvです。
GET /api/v1/prices?country=lv&service=<id>は、最新の価格と、そのルートが今注文できるかを返します。POST /api/v1/activationsに{"service": "whatsapp", "country": "lv"}を渡すと、アクティベーションが作成され、そのIDと+371番号が返ります。- その番号をアプリケーションに入力します。
- Webhookでコードを待つか、数秒おきに
GET /api/v1/activations/{id}をポーリングします。 - テストを中止した場合は、
POST /api/v1/activations/{id}/cancelで番号を解放し、返金を受けます。
バッチを実行する前にGET /api/v1/balanceを呼び出しておけば、残高が少ないときにジョブを早めに止められます。上限は、APIキー10個、Webhookエンドポイント5つ、1分あたり300リクエストです。
署名付きWebhookで+371のコードを受け取るには
ポーリングは手早いスクリプト向きで、Webhookは並列のCIジョブ向きです。エンドポイントをactivation.sms_received、activation.expired、activation.cancelledに登録します。
各リクエストにはX-OTPRoute-Signature: t=<unix>,v1=<hex>が含まれます。<t>.<raw body>という文字列を組み立て、エンドポイントのシークレットでHMAC-SHA256の署名を作り、v1と定数時間で比較し、古すぎるタイムスタンプは拒否します。ハンドラーはアクティベーションIDをキーにして、同じ配信が繰り返されても2回目の処理が走らないようにしてください。詳しい手順は、HMACでOTP Webhookを保護するにあります。
ダッシュボードの使い方と、コードが届かない場合の対処
コードを書かない場合は、ダッシュボードでOTP Gatewayを開き、ラトビアとサービスを選び、表示された価格を確認して注文し、+371番号をアプリに貼り付けます。コードは、受信するとアクティベーションに表示されます。
届かない場合は、20分のウィンドウが終わるまで待ちます。届かなかったコードの料金はかかりませんし、早めにキャンセルしても返金されます。そのうえで、サービスが仮想番号を拒否していないか確認します（拒否するものもあります）。時間をおくか別のサービスルートでやり直し、新しい注文を矢継ぎ早に出すのは避けてください。
ラトビアのOTPルーティングの課金はどうなっているのか？
料金はプリペイドのUSDウォレット1つにまとまっており、サブスクリプションもプラン選択もありません。バルト地域のチームは、カードまたはUSDT/USDCで残高をチャージでき、チャージのたびに経理用のPDF請求書がメールで届きます。連携の作業では、リクエストに応じて開発用アカウントをサンドボックスに切り替えられ、SMS認証APIクライアントを通じて、無料で模擬の番号とコードが流れます。始めるのは1分で済みます。アカウントを開設し、6桁のメールコードを使うかGoogleでサインインして、チームのためにTOTP二要素認証を有効にしてください。
番号は自社の製品と正当なアカウントにのみ使い、各サービスの規約を守ってください。OTP RouteのAcceptable Use Policyも適用されます。
よくある質問
ラトビアのSIMカードがなくても、ラトビアのSMS OTPを受信できるか？
はい。OTP Gatewayから+371番号を注文すれば、コードはダッシュボードまたはAPIで確認できます。
ラトビアの番号にトランクプレフィックスはあるか？
いいえ。ラトビアは8桁のクローズドな番号計画なので、E.164形式は+371に8桁を続けるだけです。
APIはラトビアにどの国IDを使うか？
lvです。価格クエリでも、アクティベーションのリクエストボディでも同じです。
テスト用の+371番号はいくらか？
OTP Gatewayの料金は$0.20/コードからです。サービスごとの正確な金額はGET /api/v1/pricesで返され、注文前に表示されます。
ラトビアの番号を長期でレンタルできるか？
セルフサービスの選択肢はありません。Dedicated Numbersは米国とカナダ向けの製品です。ラトビアについては[email protected]までお問い合わせください。
ラトビアの認証メッセージは何語で届くか？
サービスとアカウントのロケールによって、通常はラトビア語、ロシア語、英語のいずれかです。
+371番号にWhatsAppがコードを送ってこない場合は？
ウィンドウが終わるまで待てば、自動で返金されます。仮想番号を拒否するサービスもあるため、時間をおいて再試行するか、別のルートを試してください。
サービス名はそれぞれの所有者の商標です。OTP Route はこれらの企業と提携していません。番号は合法的にご利用いただき、各サービスの利用規約および当社の利用規定に従ってください。