QAとローンチ作業のためにドミニカ国(+1 767)の認証コードを受信する

+1 767番号は、電話番号の検証でなぜ役立つエッジケースなのですか?

ドミニカ国は北米番号計画(NANP)に属しているため、番号は米国、カナダ、カリブ海の多くの国と同じ国番号+1で始まります。ドミニカ国の番号だと見分けるカギになるのが、市外局番の767です。E.164形式では、携帯電話は+1767に7桁を続けた形になります。島の人々が長距離通話のときにダイヤルする先頭の1も同じ数字なので、取り除くべきものは何もありません。

そのため、ドミニカ国の認証用番号は、自社のサインアップフォームのリグレッションテストにうってつけです。

• 電話番号ライブラリは+1 767をドミニカ国と判定していますか。それとも黙って米国としてラベル付けしていませんか。
• ユーザーが国際番号全体を貼り付けたあとも、国選択でドミニカ国が選ばれたままになりますか。
• アナリティクスや不正対策のルールは、カリブ海の+1のトラフィックを米国のトラフィックとは別に扱っていますか。

標準の+1767XXXXXXX形式で保存し、地域は国番号だけでなく、必ず市外局番から導き出してください。

`dm`のOTPルーティングAPIの呼び出し手順はどうなりますか?

ドミニカ国の国IDはdmです。SMS認証APIを使った典型的な連携では、4つの呼び出しを行います。

1. GET /api/v1/prices?country=dm&service=<id>で、テストするサービスのリアルタイム価格を取得します。
2. {"service": "telegram", "country": "dm"}のようなJSONボディでPOST /api/v1/activationsを呼びます。レスポンスに番号とアクティベーションIDが含まれます。
3. テスト対象のプロダクトに番号を入力し、Webhookでactivation.sms_receivedイベントを待つか、GET /api/v1/activations/{id}をポーリングします。
4. テストを取りやめる場合は、POST /api/v1/activations/{id}/cancelを呼んで、保留分をウォレットに戻します。

認証には、or_live_で始まるBearerキーを使います。各Webhookの配信にはX-OTPRoute-Signatureヘッダーが含まれます。タイムスタンプ、ドット、生のボディをつなげた文字列に対して、エンドポイントのシークレットでHMAC-SHA256を再計算し、古いタイムスタンプは拒否してください。Webhookによるコード取得のガイドでハンドラーの例を解説しており、詳細なリファレンスはドキュメントにあります。

現在ドミニカ国のルートでは、どのサービスを認証できますか?

ドミニカ国の最新のスナップショットには、600を超えるサービスが掲載されています。人気のあるものは、WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、Discord、LinkedIn、Signal、Viber、Uber、Airbnb、Amazon、Microsoft & Outlookです。

島ごとの在庫は日中に変動するため、どのリストも出発点として捉え、テストを実行する時点で利用できるものはGET /api/v1/servicesまたはダッシュボードで確認してください。東カリブ海の複数の市場を担当するチームは、ドミニカ国をセントルシアなどのルートと組み合わせることがよくあります。

APIにアクセスできない人でもドミニカ国のコードを注文できますか?

はい。オペレーションスタッフやテスト担当者は、すべてブラウザ上で作業できます。サインインし、国にドミニカ国を選び、サービスを選び、画面に表示された価格を確認して注文します。+1 767番号がすぐに表示され、SMSが届くとその隣にコードが表示されます。同じアクティベーションは開発者からもAPI経由で見えるため、混成のチームでも1つのワークフローを共有できます。

20分の有効時間が何も届かないまま終わったらどうなりますか?

すべてのアクティベーションは20分間有効です。その間にSMSが番号に届かなかった場合、またはその前にキャンセルした場合は、全額が自動的にウォレットへ戻ります。お支払いはコードが届いたときだけです。

ドミニカ国のコードが届かないときは、次を試してください。

• 数秒でキャンセルせず、有効時間が終わるまで待ちます。
• そのフローでサービスが仮想番号を受け付けているかを確認します。受け付けないサービスもあり、だからこそ返金制度があります。
• 時間をおいて再試行するか、テストケースが許すなら別のサービスルートを試します。
• CIから短い間隔で再注文を繰り返すのは避け、試行の間隔を空けてください。

小さな島のルートに合ったバックオフとフォールバックの考え方は、OTP配信失敗を減らす方法をお読みください。

ドミニカ国の長期回線はありますか?料金の扱いは?

ドミニカ国向けのセルフサービスの長期番号はありません。専用番号(Dedicated Numbers)は米国とカナダ向けの製品で、1か月$1.95からです。また、米国やカナダの回線は、同じ+1で始まるからといってドミニカ国の番号になるわけではありません。767の回線を継続して使いたい場合は、[email protected]までメールでご相談ください。提供の可否は現地の規制によるため、確約はできません。

料金は、月額料金もプランもない前払いのUSDウォレット1つで運用されます。クレジットカード、またはUSDT/USDCのステーブルコインでチャージでき、チャージごとのPDF請求書が受信トレイに届きます。連携の開発中は、リクエストに応じて開発用アカウントをサンドボックスに切り替えられます。ウォレットの残高を使わずに、シミュレーションされた番号とコードでパイプラインを検証できます。番号は、自社の正当なプロダクトとアカウントのためにのみ使い、各サービスの利用規約に従ってください。OTP Routeの利用規定(Acceptable Use Policy)も適用されます。

よくある質問

現地のSIMがなくても、自社アプリのドミニカ国向けサインアップフローをテストできますか?

はい。OTP Gatewayで+1 767番号を注文し、アプリに入力して、コードをダッシュボードで読み取るか、APIや署名付きWebhookで受け取ります。

電話番号ライブラリが+1 767番号を米国のものと判定してしまうのはなぜですか?

一部のライブラリは、+1を見ると米国の地域をデフォルトにします。E.164形式の文字列全体を渡し、ライブラリに767の市外局番から地域を判定させたうえで、UIにドミニカ国が表示されることを確認してください。

APIでドミニカ国に使う国IDは何ですか?

IDはdmです。価格の照会では国パラメータとして、アクティベーションの作成ではcountryフィールドとしてdmを渡します。

ドミニカ国の認証用番号はいくらですか?

料金は1コード$0.20からです。正確な金額はサービスによって異なり、価格エンドポイントからリアルタイムに返され、確定前にダッシュボードにも表示されます。基本的な料金モデルは料金ページをご覧ください。

SMSが届かなかった場合も支払いますか?

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

ドミニカ国のOTPは通常、何語で届きますか?

公用語は英語なので、コードのほとんどは英語で届きますが、文面は各サービスのテンプレートによって異なります。固定の文言ではなく、数字を解析してください。

同じドミニカ国の番号を、今後のログインのために保持できますか?

セルフサービスの製品としては提供していません。Gatewayの番号は、1回の認証コード専用です。長期の回線を即時に提供するのは、米国とカナダのみです。

すべてのサービスが、テスト用の+1 767番号を受け付けますか?

いいえ。どの番号を受け付けるかは各サービスが決めており、仮想番号を拒否するものもあります。コードが届かなかった場合は返金されるので、時間をおいて再試行できます。

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