スペインの+34認証コードをテストとダッシュボードに取り込む

必要なのは1回のコード用の+34番号ですか、それとも保持するスペインの回線ですか?

どちらのプロダクトを開くかが決まるので、ここから始めてください。私たちが目にするスペイン関連のタスクのほぼすべては使い捨てです。新しいサインアップ画面がコードを送信するかの確認、リリース後のオンボーディング回帰テストの再実行、スペインで事業を行うチームのビジネスプロフィールの認証などです。これはOTP Gatewayの領域で、各番号はちょうど1つのコードを受け取るために存在します。

数か月後に同じアカウントへ再ログインする予定なら、使い捨て番号は適切なツールではなく、代わりのスペインの番号も用意されていません。セルフサービスのDedicated Numberは米国とカナダのみで、月額$1.95から、SMS受信、SMS送信、ブラウザからの通話に対応します。スペイン向けのセルフサービス長期回線はありません。[email protected]にメールで問い合わせることはできますが、可能かどうかは現地の規則次第です。

スペインの身元を必要としない、繰り返し使うステージングのログインには、通常は仮想番号のページにある米国またはカナダの回線の方がすっきりした答えになります。

スペインの電話番号に特有の点は何ですか?

スペインには市外プレフィックスがありません。国内番号は9桁で、国内でダイヤルする形と+34の後に書く形は同じで、携帯電話は6または7で始まります。したがってE.164形式のスペインの携帯番号は、+34に、6または7で始まる9桁を続けたものです。正規化とは主に、スペース、ドット、そして一部のユーザーが貼り付けるオプションの国際プレフィックス0034を取り除くことです。

フォームのテストには、次の2つのチェックを加える価値があります。0034付きで入力された番号は、+34付きで入力されたものと同じ保存値に統一されること。また、フローが携帯電話を必要とする場合は、9で始まる固定電話は早い段階で弾くことです。

言語も重要です。スペイン語が国の言語ですが、カタルーニャ語、ガリシア語、バスク語がそれぞれの地域で共同公用語となっているため、スペインのユーザーは4つのいずれの言語でもアプリを使う可能性があります。+34番号への認証SMSはほとんどがスペイン語か英語で届きますが、コードの抽出が周囲の文言に依存してはいけません。

今日、スペインの認証番号で使えるサービスは?

スペインのルートは1,900を超えるサービスをカバーしています。よくリクエストされるものには、WhatsApp、Telegram、Google(Gmail & YouTube)、Instagram、Facebook、TikTok、Amazon、Airbnb、eBay、Microsoft & Outlook、LinkedIn、Signal、Claude、Netflixなどがあります。

可用性は固定のリストではなくライブの値です。実行の開始時にGET /api/v1/countriesと、esに対する価格エンドポイントを照会し、一時的に利用できないサービスがきれいにスキップされるようにしてください。

開発者でない人は、ダッシュボードでどうやってスペインの番号を注文しますか?

プロダクトマネージャー、サポートリード、ローカライズのレビュアーがAPIキーに触れたがることはまずありませんし、その必要もありません。

1. サインインして、OTP Gatewayを開きます。
2. スペインを選び、続いて確認したい画面のサービスを選びます。
3. 確定する前に表示される価格を確認します。価格はサービスによって異なります。
4. +34番号をアプリにコピーして、コードをリクエストします。
5. タブを開いたままにします。メッセージの本文は、届くとアクティベーションの行に表示されます。

多くのチームは、スペイン語ビルドでの時折の手動チェックや、運用部門が管理するビジネスアカウントの一度きりの確認を、この方法で行っています。

スペインのOTP APIをCIに組み込むには?

自動化されたスイートは、or_live_で始まるBearerキーを付けて、https://otproute.com/api/v1配下の同じRESTエンドポイントを呼び出します。スペインの国IDはesです。

• GET /api/v1/prices?country=es&service=<id>は、その組み合わせの本日のコストを返します。
• POST /api/v1/activations に {"service": "instagram", "country": "es"} を送ると、注文が作成され、番号とアクティベーションIDが返ります。
• GET /api/v1/activations/{id}はポーリング用の状態を返します。POST /api/v1/activations/{id}/cancelは、テストで不要になった注文を解放します。
• GET /api/v1/balanceを使えば、資金が少ないときにパイプラインを早めに止められます。

並列ジョブでは、Webhookエンドポイントでactivation.sms_received、activation.expired、activation.cancelledを購読します。X-OTPRoute-Signatureヘッダーを、エンドポイントのシークレットで<t>.<raw body>に対するHMAC-SHA256を再計算して検証し、古いタイムスタンプは拒否し、リトライしても影響が出ないよう結果はアクティベーションIDで保存してください。完全なハンドラーは、WebhookベースのOTPキャプチャのウォークスルーで確認できます。上限はアカウントあたり、キー10個、エンドポイント5個、1分あたり300リクエストです。

スペインのコードが届かないことがあるのはなぜで、そのときはどうすればいいですか?

各アクティベーションは20分間有効で、課金されるのはコードが届いたときだけです。キャンセルした注文、またはSMSが届かずにウィンドウが終了した注文は、チケットなしで全額がウォレットに返金されます。

+34の注文が空のままの場合は、まずウィンドウの時間いっぱいまで待ってください。それでも失敗するなら、最も多い原因は、そのフローでサービスが仮想番号を拒否していることで、返金ルールはこれを吸収するために設計されています。その後は、時間を変えるか別のサービスルートで再試行し、自動化されたジョブがエンドポイントを連打しないよう、試行の間に間隔を入れてください。こうした状況に耐えるテストの設計方法は、モバイルアプリ認証のページで解説しています。

スペインで作業するチームにとって、OTP Routeの課金はどうなっていますか?

課金は、サブスクリプションもティアもない、米国ドル建ての単一のプリペイドウォレットから、利用ごとに行われます。チームはカードまたはUSDT/USDCでチャージでき、チャージや番号購入のたびにPDFの請求書がメールで届くので、EUの経理処理も簡単です。最新の料金は料金ページにあります。

連携の期間中は、開発アカウントのサンドボックスへの切り替えをリクエストしてください。シミュレートされた番号とコードが返され、スペインのパスをコストなしでエンドツーエンドにテストできます。OTP Routeは、ご自身の正当なプロダクトとアカウントのテストと運用を目的としています。各サービスの利用規約を守ってください。利用規定(Acceptable Use Policy)はすべての注文に適用されます。

よくある質問

スペインのSIMなしで、アプリのスペイン向けサインアップフローを確認できますか?

はい。OTP Gatewayで+34番号を注文してアプリに入力すれば、コードがダッシュボードまたはAPIに表示されます。

スペインのAPI国IDは何ですか?

esで、POST /api/v1/activationsやGET /api/v1/pricesなどの呼び出しで使います。

スペインの番号には、取り除くべき市外の0がありますか?

いいえ。スペインには市外プレフィックスがないため、9桁の国内番号が+34の直後に続きます。スペースと0034プレフィックスだけを取り除いてください。

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

1コード$0.20からです。サービスごとのライブ価格はAPIから返され、ダッシュボードにも表示されます。課金されるのはコードが届いた場合のみです。

スペインの番号を長期ログイン用にレンタルできますか?

スペインにはセルフサービスのオプションはありません。長期のDedicated Numberは米国とカナダのみで、月額$1.95からです。スペインについては[email protected]にメールでお問い合わせください。

コードはカタルーニャ語やバスク語で届きますか?

アプリがユーザーの選択した言語で送信することもまれにありますが、スペイン語か英語が最も一般的です。文言でテストが壊れないよう、数字を抽出してください。

ウォレットの資金を使わずにテストする方法はありますか?

はい。開発アカウントでサンドボックスを依頼すると、シミュレートされた番号とコードを受け取れます。

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