プロダクト・QAチームのためのニューカレドニア(+687)認証コード

ワンタイムコードか長期回線か:ニューカレドニアのプロジェクトにはどちらが必要ですか?

これは最初に決めてください。連携の残りの部分を左右するからです。

• OTP Gateway の番号は、1回の認証用です。+687 の番号を確保し、コードを1回受信すると、アクティベーションは終了します。サインアップのテスト、ローカライズの確認、毎回新しいテストアカウントを作成するCIの実行に適しています。
• Dedicated Numbers は、更新される限り保持できる回線で、受信と送信のSMSに加えてブラウザー通話が付きます。販売されているのは米国とカナダのみで、$1.95/月からです。ニューカレドニアにはセルフサービスの同等のものはありません。

ニューカレドニアの回線を、アカウントと数か月にわたって紐づけておく必要がある場合は、[email protected] にメールして、用途をお知らせください。提供可否は現地の規則によるもので、約束はできません。一度に1つのコードが必要な用途なら、ゲートウェイが適切なツールです。さらに詳しい比較は、一時的な番号と専用番号 をご覧ください。

ニューカレドニアのルートでは、OTP Gateway をどう呼び出しますか?

すべてのリクエストは、or_live_ プレフィックス付きの Bearer キーで https://otproute.com/api/v1 に送ります。キーは Developer console で生成でき、1アカウントあたり最大10個で、環境ごとにローテーションします。

1. GET /api/v1/countries でルートを調べます。ニューカレドニアのIDは nc です。
2. GET /api/v1/services からサービスIDを取得します。
3. GET /api/v1/prices?country=nc&service=<id> に、リアルタイムの料金と可用性を問い合わせます。
4. POST /api/v1/activations に {"service": "facebook", "country": "nc"} のような本文を送ってアクティベーションを作成し、返されたアクティベーション ID を保持します。
5. テスト中のアプリに +687 の番号を入力します。
6. Webhook でコードを受信するか、GET /api/v1/activations/{id} をポーリングします。テストを中止するときは POST /api/v1/activations/{id}/cancel を呼び出します。

バッチの前に GET /api/v1/balance を呼び出しておくと、ウォレットが空のときにすぐに失敗させられます。このニューカレドニアのOTP APIに関するSDKのメモとドキュメントは、開発者向けページ にまとめられています。

+687のコードの署名付き Webhook はどのようなものですか?

最大5つのエンドポイントを登録し、必要なイベントを選びます。activation.sms_received、activation.expired、activation.cancelled です。各配信には、t=<unix>,v1=<hex> という形式の X-OTPRoute-Signature ヘッダーが付きます。

配信を信頼するには、<t>.<raw body> にエンドポイントのシークレットで HMAC-SHA256 の署名を行い、それを v1 と定数時間で比較します。古いタイムスタンプのものはすべて破棄します。同じイベントが再度送られることがあるため、処理済みのイベントをアクティベーション ID で索引化し、重複はスキップしてください。ポーリングのほうがよいチームは、1分あたり300リクエストの上限の範囲内で行えます。

ニューカレドニアのSMS OTPコードを受信できるサービスは?

このルートでは現在、700を超えるサービスを扱っています。リアルタイムのスナップショットには、WhatsApp、Facebook、Instagram、Google(Gmail & YouTube)、Microsoft & Outlook、Amazon、Airbnb、Uber、Netflix、Telegram、LinkedIn、Snapchat、TikTok が含まれます。

カタログは大きな市場に比べて小さく、一日の中で変動するため、注文するその瞬間のAPIから、必ず可用性を読み取ってください。サービスが見当たらない場合は、時間をおいて再確認するか、近隣のルートを前提にテストを計画してください。

+687の番号は、バリデーションとローカライズでどう違いますか?

ニューカレドニアは、トランクプレフィックスのない、6桁で閉じた番号計画を使っているため、E.164形式は +687 に6桁が続くだけです。より長い国内番号向けに調整されたバリデーターは、これを拒否しがちなので、どの電話番号欄にも役立つエッジケースになります。E.164の文字列全体を保存し、他の市場からコピーした桁数のルールは避けてください。

公用語はフランス語で、島々ではカナク諸語も数多く話されています。認証メッセージはフランス語か英語で届くと想定し、アクセント付き文字を含むテンプレートがログで正しく表示されるか確認してください。この領土は夏時間のない UTC+11 で動いており、テストがタイムスタンプや有効期限をアサートする場合には重要になります。

チームがここに来るのは、ヨーロッパ以外でフランス語のフローをQAするため、観光やホスピタリティのプロダクトをサポートするため、そして太平洋地域の運用のためのアカウントを認証するためです。アプリチームがこうしたチェックをどう設定しているかは、モバイルアプリ認証 のページで紹介しています。

開発者でない人は、ニューカレドニアの認証番号をどう取得しますか?

ダッシュボードにコードは必要ありません。メールアドレスと6桁のコード、または Google でサインアップし、TOTP を有効にします。ウォレットにチャージし、ニューカレドニアとサービスを選び、表示された料金を確認してから確定します。+687 の番号をアプリに貼り付けて、コードが表示されるまでアクティベーションを見守ります。

20分以内に何も届かなかったらどうなりますか?

課金されるのはコードが届いたときだけです。何も届かないまま有効時間が切れたとき、またはキャンセルしたときは、課金額の全額が自動的にウォレットに戻ります。

• アクティベーションの時間を最後まで待つ。配信はサービスとルートによって決まります。
• 時間帯を変えて再試行するか、テストが許せば別のサービスルートを試す。
• そのサービスが仮想番号を受け付けるかを確認する。拒否するものもあり、返金はそれに対する保護です。
• 急速なループで再注文するのは避け、試行の間隔をあけ、各アクティベーション ID を記録する。

ニューカレドニアのテストは、どう課金されますか?

すべて、1つの前払いUSDウォレットから引き落とされます。月額料金もなく、選ぶべきプランもありません。カードまたは USDT/USDC で資金を追加でき、チャージのたびにPDFの請求書がメールで届きます。連携作業のためには、開発用アカウントでサンドボックスモードを依頼すれば、ウォレットの負担なしに、シミュレートされた番号とコードが得られます。

OTP Route は、自社の正当なプロダクトとアカウントのテストと運用のためのものです。太平洋市場でのテストも、各サービス自身の利用規約と、当社の利用規定(Acceptable Use Policy)の対象です。

よくある質問

現地のSIMカードなしで、ニューカレドニアのサインアップフローをテストできますか?

はい。OTP Gateway で +687 の番号を注文し、アプリで使って、ダッシュボードか API でコードを読み取ります。

APIでのニューカレドニアの国IDは何ですか?

nc で、料金の問い合わせとアクティベーションのリクエスト本文の両方で使用します。

ニューカレドニアの電話番号は何桁ですか?

+687 の国番号の後に6桁で、トランクプレフィックスはありません。E.164形式で保存し、他の国の桁数のルールは適用しないでください。

テスト用の +687 の番号はいくらですか?

1コード $0.20 からで、サービスごとの正確なリアルタイムの料金は、注文前に GET /api/v1/prices から返されます。

ニューカレドニアの長期番号を借りることはできますか?

セルフサービスの選択肢はありません。長期の Dedicated Numbers は米国とカナダのみです。ニューカレドニアの回線については、[email protected] にメールでお問い合わせいただけます。

ニューカレドニアのOTPメッセージは、何語で届きますか?

サービスによって、通常はフランス語か英語です。どちらにも対応できるよう、数字のコードを解析してください。

コードが来なかった場合、+687の注文は返金されますか?

はい。20分の有効時間が終了するか、キャンセルした時点で、ウォレットに全額が自動的に戻ります。

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