イギリスの認証番号:+44 OTPテストのチェックリスト

チェックリスト:あなたのスタックは+44の認証コードを受け取る準備ができていますか?

リリース候補がテスト計画のUK区間に入る前に、次のリストを確認してください。

• [ ] そのジョブ専用に権限を絞った、Developerコンソールのキー(or_live_ 接頭辞)。
• [ ] フィクスチャに組み込んだUKの国id gb と、GET /api/v1/services で調べたサービスid。
• [ ] 配信方法の決定:並列のテストスイートには署名付きWebhook、手早いスクリプトにはポーリング。
• [ ] UKの先頭のゼロを扱える電話番号のパース処理(詳しくは後述)。
• [ ] GET /api/v1/balance で確認した十分な残高、またはドライラン用のサンドボックスアカウント。
• [ ] 1つの番号は、ちょうど1つのコードにしか使えないという、運用手順書へのメモ。

これをパイプラインに組み込むチームには、CIパイプラインでのSMS OTPテストが役立ちます。

国id gbでのUK OTP APIのフローはどう動きますか?

この手順は、人間のテスターが手作業で行うことをそのままなぞったもので、より速く、記録が残るだけです。

1. GET /api/v1/prices?country=gb&service=<id> でその組み合わせの料金を調べます。レスポンスはライブの提供状況を反映しています。
2. POST /api/v1/activations に {"service": "<id>", "country": "gb"} を送り、番号を確保します。
3. +44の番号をサインアップ、ログイン、またはリカバリー画面に入力し、SMSをリクエストします。
4. activation.sms_received イベントか、GET /api/v1/activations/{id} を読むことでコードを受け取ります。
5. テストをスキップするときは、POST /api/v1/activations/{id}/cancel で後腐れなく中止します。

Webhookのハンドラーは、X-OTPRoute-Signature ヘッダーの検証が通るまで、すべてのリクエストを信頼しないものとして扱ってください。エンドポイントのシークレットで <t>.<raw body> に対して計算したHMAC-SHA256が v1 と一致し、タイムスタンプが新しい必要があります。重複した配信が無害になるよう、結果はアクティベーションidをキーに保存します。ほとんどのテストスイートには十分な上限です。1分あたり300リクエスト、1アカウントにつきキー最大10個、Webhookエンドポイント最大5つです。詳しいリファレンスは開発者ドキュメントにあります。

UKのルートには、どのサービスやアプリがありますか?

イギリスは対応の広いルートの一つで、4,000を超えるサービスを利用できます。人気のものには、WhatsApp、Google (Gmail & YouTube)、Amazon、Uber、Netflix、eBay、Airbnb、LinkedIn、Microsoft & Outlook、Instagram、Snapchat、X (Twitter)、Discord、ChatGPT (OpenAI)があります。

ルートは時間単位で変わります。昨日の結果が今も有効だと考えず、今注文できるものは料金エンドポイントやダッシュボードで確認してください。

先頭のゼロの扱い:UKの携帯番号をE.164で保存する

イギリスのトランク接頭辞は0です。携帯番号は 07xxx xxxxxx の11桁で書かれますが、国際形式では0がなくなり、+447xxxxxxxxx になります。UKの電話番号欄で最もよくあるバグは、両方を残してしまうことです。その結果、どのSMSゲートウェイも配信できない無効な +4407… という文字列ができてしまいます。

テストスイートに加える価値のあるチェックは、次のとおりです。

• 07… の入力が、保存前に +447… に正規化される。
• すでに +44 7… の形になっている入力が、そのまま通る。
• おなじみの 07xxx xxxxxx のグループ分けにあるスペースが取り除かれる。
• 表示用の整形は出力時にのみ行い、保存はしない。

イギリスのユーザー向けの認証メッセージは英語で届きます。ウェールズでは、ウェールズ語も公用語の一つであるため、二言語のインターフェースを持つ一般向けサービスでは、テンプレートや画面が両方の言語で正しく動くか確認するとよいでしょう。

QAチームやグロースチームがイギリスの番号でテストする理由

多くの企業にとって、UKは本拠地の市場か、その外で最初に進出する市場です。特に金融商品では、電話番号の認証がオンボーディングやステップアップ認証の中心に置かれる傾向があるため、+44のフローが壊れていると、サポートの問い合わせキューにすぐ表れます。

テスト用に+44番号を注文する、よくある理由は次のとおりです。

• UKでのローンチ。en-GB版では、スペル、日付形式、国選択について独自のテストが必要です。
• SMSプロバイダーの設定を変更した後の、ログインとアカウントリカバリーのリグレッションテスト。
• 失敗したイギリス人顧客のサインアップを再現して、コードがどこで失われたのかを確かめること。

こうしたチェックをチームがどう組み立てているかは、フィンテックのオンボーディングのページで説明しています。

+44のコードが届かないときのトラブルシューティング

コードが届かないときは、すぐに再注文したくなる気持ちを抑えてください。代わりに、次のようにします。

1. 20分のウィンドウが終わるまで待ちます。サービスによっては、メッセージをしばらく保留します。
2. アクティベーションのステータスを読みます。expiredで終わっていれば、何も届かなかったということで、全額はすでにウォレットに戻っています。
3. サービスによっては仮想番号を拒否することを思い出してください。その結果こそ、返金ルールがカバーしているものです。
4. 注文をループさせるのではなく、間をおいてから、または同じサービスの別のルートで再試行します。
5. アプリがそもそもSMSをリクエストしたこと、そして古いフィクスチャではなく、確保した+44番号に送られたことを確認します。

ダッシュボードでの手順、請求、UKの長期回線

開発者でない人も、コードなしでこれらをすべて行えます。ダッシュボードを開き、イギリスとサービスを選び、表示された料金を確認して番号をアプリにコピーし、同じページでコードを待ちます。

セルフサービスで使えるUKの長期番号はありません。専用番号はアメリカとカナダ向けの製品で、月額$1.95からです。恒久的なイギリスの回線については [email protected] にメールでご連絡ください。チームが、現地の規則で何が認められるかをお約束なしでご説明します。すべては、月額料金のないプリペイドのUSDウォレットで動き、チャージはカードまたはUSDT/USDCで、PDFの請求書がメールで届きます。詳細は料金ページにあります。

よくある質問

イギリスのSIMなしで、アプリのUKサインアップフローをテストできますか?

はい。OTP Gatewayで+44の番号をリクエストし、サインアップ画面に入力して、ダッシュボード、Webhook、またはアクティベーションのエンドポイントからコードを読み取ります。

APIでのUKの国idは `uk` ですか、`gb` ですか?

gb です。ISOの国コードに従っています。

07で始まるUKの番号を変換するにはどうしますか?

先頭の0を取り除いて+44を付けます。つまり 07… が +447… になります。

タイムアウトしたUKのアクティベーションにも料金を支払いますか?

いいえ。20分以内にSMSが届かない場合、またはキャンセルした場合は、全額がウォレットに自動で返金されます。

OTP Routeは、数か月間保持できるUKの番号を提供できますか?

セルフサービス製品としては提供していません。長期の専用番号はアメリカとカナダのみで販売しています。UKについてはサポートにメールでお尋ねいただけますが、可能であるという保証はありません。

UKの連携を、先にサンドボックスで試せますか?

はい。リクエストに応じて、開発用アカウントをサンドボックスに切り替えられます。模擬の番号とコードが返されるため、ウォレットの残高を使わずにテストできます。

UKの認証番号には、どのような利用ルールが適用されますか?

各サービスの規約とOTP Routeの利用規定(Acceptable Use Policy)に従い、ご自身の正当なプロダクト、テスト、ビジネスアカウントにのみ番号を使ってください。

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