開発者向け:モルドバ(+373)の認証コードガイド

リクエストからコードまで、+373のアクティベーションはどう進みますか?

アクティベーションは、ID、電話番号、ステータスを持つ短命なオブジェクトです。クライアントは、Developerコンソールで生成した or_live_ で始まるBearerキー(1アカウントにつき最大10キー、1分あたり300リクエスト)で https://otproute.com/api/v1 に認証します。

モルドバでのライフサイクルは次のとおりです。ジョブはまず GET /api/v1/prices?country=md&service=<id> を読み、ルートが開いていることを確認して本日の価格を把握します。次に {"service": "<id>", "country": "md"} で POST /api/v1/activations を送信し、アクティベーションIDと+373番号を受け取ります。テストはその番号を対象アプリに入力してSMSを送信させます。この時点からアクティベーションは20分間有効で、コードを受信したとき、POST /api/v1/activations/{id}/cancel を呼び出したとき、または時間切れになったときに終了します。

サービスIDと国の完全なカタログは、GET /api/v1/services と GET /api/v1/countries から取得できます。リアルタイムの一覧が信頼できる情報源なので、ハードコードせず起動時に取得してください。完全なクライアントの例はOTP APIインテグレーションガイドにあります。

モルドバOTP APIのクライアントは、ポーリングとWebhookのどちらにすべきですか?

同じSMS認証APIでどちらも使え、多くのチームは両方を併用します。速度のためにWebhook、安全網としてポーリングです。

Webhook。 Developerコンソールでエンドポイントを追加し(1アカウントで5つ登録可能)、activation.sms_received、activation.expired、activation.cancelled を処理します。t=<unix>,v1=<hex> 形式の X-OTPRoute-Signature ヘッダーは、エンドポイントのシークレットで <t>.<raw body> のHMAC-SHA256を計算して検証し、古いタイムスタンプは拒否します。処理はアクティベーションIDをキーにして、重複配信が無害になるようにしてください。

ポーリング。 バックオフを付けて数秒おきに GET /api/v1/activations/{id} を呼び出し、ステータスが確定したら停止します。受信リクエストを受け付けられない、ファイアウォールの内側のCIランナーに向いています。両方のパターンのタイムアウトとリトライについては、CIパイプラインでのSMS OTPテストの記事で扱っています。

モルドバの電話番号は、扱いがどう違いますか?

モルドバの国内番号は +373 の国番号の後に8桁が続き、国内ダイヤルでは先頭にトランクプレフィックス 0 が付きます。そのため、ユーザーは同じ携帯番号を複数の形で入力します。先頭に 0 を付けたもの、+373 付き、00373 付きです。スペースとダッシュを取り除き、国番号を付けるときは国内の 0 を外して、E.164形式で保存して正規化してください。先頭のゼロを必須とするバリデーターは、正しい形式の国際入力を拒否してしまいます。これは+373のテスト用番号が最初に露呈させがちな問題のひとつです。

公用語はルーマニア語で、ロシア語も広く話されているため、現地サービスからの認証テキストはどちらか、またはグローバルアプリからは英語で届くことがあります。キリル文字のメッセージはより広いエンコーディングで送信され、ラテン文字とは分割のされ方も異なるので、コードを抽出するパーサーではその点も確認しておく価値があります。

モルドバでテストするのは、アプリをルーマニア語やロシア語にローカライズするとき、地域をまたいで顧客に対応するとき、あるいはキシナウにいるサポートやエンジニアリングのスタッフの認証手順を確認する必要があるときです。

現在、モルドバにコードをルーティングしているアプリは?

OTP Routeはモルドバで1,700を超えるサービスを掲載しています。現在のスナップショットで人気のものは、Telegram、Viber、WhatsApp、Signal、Facebook、Instagram、TikTok、Google(Gmail & YouTube)、LinkedIn、Snapchat、Amazon、eBay、Netflix、Claudeなどです。

これは動いている状況の一コマとして扱ってください。在庫は一日の中で変わるため、実行のたびにリアルタイムの一覧を取得し、不安定なサービスのためにフォールバックのルートを用意しておきましょう。国別ルーティングの記事では、テストロジックを変えずにフォールバック先の国へOTPルーティングする仕組みを説明しています。

モルドバのコードが表示されないのはなぜですか?

サービスが仮想番号を完全に拒否する、繰り返しの試行を制限する、特定のルートで配信が遅い、といったことがあります。いずれも費用はかかりません。20分のウィンドウ内にコードが届かなければ、ウォレットに自動で全額返金されるからです。

その場合の実践的な手順は次のとおりです。

• 最初の沈黙でキャンセルせず、ウィンドウが終わるまで待ちます。
• そもそもサービスが仮想番号を受け付けているか確認します。
• 時間をおいて再試行するか、サービスが対応している別の国に切り替えます。
• 繰り返しの注文は間隔を空けます。新しいアクティベーションを立て続けに出すのは逆効果です。
• アクティベーションIDをアプリのログと並べて記録し、失敗した実行と成功した実行を比較できるようにします。

コードを書かない人がモルドバの番号を注文するには?

メールと6桁のメールコード、またはGoogleサインインで、サインアップからアカウントを作成します。OTP Gatewayでサービスを選び、モルドバを選択し、リアルタイム価格を確認して確定します。認証対象のアプリに+373番号を貼り付けてください。コードを受信するとすぐにダッシュボードに表示されます。同じ画面からキャンセルでき、その場合は金額がすぐにウォレットへ戻ります。

長期回線、サンドボックス、支払いについては?

OTP Routeは、モルドバのセルフサービスの長期番号は販売していません。Dedicated Numbersは米国とカナダでのみ提供しており、$1.95/月からです。継続的な+373回線が必要な場合は [email protected] まで書いてください。手配できるかどうかは現地の規則によります。

支払いは、サブスクリプションも階層もない、単一のUSDウォレットからの従量課金です。カードまたはUSDT/USDCで資金を追加し、チャージごとにPDFの請求書がメールで届きます。先に連携のリハーサルをしたい開発者は、アカウントをサンドボックスに切り替えるよう依頼できます。そこでは番号とコードがシミュレートされ、ウォレットには手を付けません。

よくある質問

モルドバに住んでいなくても、モルドバのSMS OTPを受信できますか?

はい。OTP Gatewayは、どこからでも使える+373番号を発行し、コードはダッシュボードに表示されるか、APIクライアントに送られます。

モルドバについて、コードにはどの国IDを送ればよいですか?

country の値として md を送ります。サービスIDは GET /api/v1/services から取得します。

モルドバの番号は先頭の0を付けて保存すべきですか?

いいえ。国内のトランクプレフィックスを外し、E.164で +373 に国内の8桁を続けた形で保存します。

モルドバのアクティベーションをキャンセルするとどうなりますか?

コードが届く前に POST /api/v1/activations/{id}/cancel を呼び出すと、アクティベーションが終了し、全額がウォレットに返金されます。

数か月間保持できるモルドバの認証番号はありますか?

セルフサービスではありません。長期のDedicated Numbersは米国とカナダ向けの製品です。モルドバについてはサポートにメールでお問い合わせください。

OTP Routeを使って、1つのアプリで多数のアカウントを作れますか?

いいえ。自社の正当な製品とアカウントのテストと運用のためのもので、各サービスの規約とOTP Routeの利用規定(Acceptable Use Policy)の範囲内で使用します。

お金をかけずに、テストスイートをモルドバに対して実行できますか?

はい、開発アカウントにサンドボックスモードを依頼すれば可能です。エンドツーエンドのテスト用に、シミュレートされた番号とコードが返ります。

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