スイス(+41)の認証コードを開発者向けに受け取る方法

APIでスイスのコードを取得するにはどのリクエストを使いますか?

スイス向けOTP APIは他の国と同じシンプルな構成で、国IDには ch を使います。認証には、開発者コンソールで作成したBearerキー(プレフィックス or_live_)を使います。1つのアカウントで最大10個のキーを保持できます。

1. GET /api/v1/services と GET /api/v1/countries でIDを取得し、実行間でキャッシュします。
2. GET /api/v1/prices?country=ch&service=<id> を確認します。レスポンスには現在の価格と、今すぐ使えるルートがあるかどうかが含まれます。
3. POST /api/v1/activations に {"service": "whatsapp", "country": "ch"} など、テスト対象のサービスを指定して送信します。返されたアクティベーションIDは保存しておきます。
4. +41の番号を、ご自身のプロダクトの電話番号欄に入力します。
5. 結果は GET /api/v1/activations/{id} またはWebhookで受け取ります。中止する場合は POST /api/v1/activations/{id}/cancel で問題なくキャンセルできます。

GET /api/v1/balance はテストスイートのセットアップ手順に組み込むのがおすすめです。レート制限はアカウントあたり1分300リクエストで、余裕のある間隔でポーリングする複数のジョブを同時に回しても十分です。エンドポイントの詳細はドキュメントをご覧ください。

+41のアクティベーションにはポーリングとWebhookのどちらが向いていますか?

簡単なスクリプトならポーリングが手軽です。ただしテストを並列実行する場合はWebhookが有利で、チューリッヒ宛てのSMSが配信されるのを待つ間、処理をぐるぐる回し続ける必要がありません。

OTP Routeでは最大5つのエンドポイントを登録でき、それぞれに activation.sms_received、activation.expired、activation.cancelled を購読させます。受信したら信頼する前に検証してください。X-OTPRoute-Signature の t と v1 を取り出し、エンドポイントのシークレットで "<t>.<raw body>" のHMAC-SHA256を計算し、定数時間で比較します。短い許容範囲を超えるタイムスタンプは拒否します。処理はアクティベーションIDをキーにしておけば、再送された配信も無害に扱えます。

署名検証について詳しくは、HMACによるOTP Webhookの保護をご覧ください。

スイスの電話番号はデータベースにどう保存すべきですか?

スイス国内では、番号の先頭にトランクプレフィックス0を付けます。たとえば携帯番号は 079 123 45 67 と表記します。国際形式ではこの0が省かれ、E.164形式は +41 79 123 45 67 となり、国番号の後ろに9桁が続きます。携帯電話の番号帯は 07x です。保存するのは正規の +41… 形式の文字列にとどめ、表示時にだけ整形してください。そうしないと、ある箇所では 079、別の箇所では +4179 と表記が混在し、重複排除や検索が壊れてしまいます。

もうひとつスイス特有の事情が言語です。ドイツ語、フランス語、イタリア語、ロマンシュ語がいずれも公用語のため、認証SMSは送信側のロケール処理によって最初の3言語のどれかで届くことがあり、多くのアプリは単に英語にフォールバックします。地域別にローカライズしているプロダクトなら、実際の+41コードで正しいテンプレートが送られるか手軽に確認できます。

スイス市場向けにフィンテックやEコマースを立ち上げる前のテスト、ジュネーブやバーゼルからビジネスアカウントを管理するスタッフのサポート、独自の国番号+423を使うリヒテンシュタインもまたぐ国境越えのフロー検証などで、このルートが活用されています。

スイスの認証番号で確認できるサービス

ch の現在のスナップショットには、Google(Gmail & YouTube)、Microsoft & Outlook、LinkedIn、WhatsApp、Telegram、Signal、Uber、Airbnb、Amazon、eBay、Netflix、Discord、ChatGPT(OpenAI)、Claudeなどが掲載されています。スイスはOTP Gatewayで合計1,700を超えるサービスに対応しています。

利用可否は一日を通して変動するため、この一覧は出発点と考え、実行時にライブデータへ問い合わせてください。先に価格を確認し、ルートが閉じていればテストをスキップ扱いにするハーネスは、やみくもに再試行するものよりずっと見通しの良いレポートになります。

スイスのアクティベーションがいつまでも空のままのときは

+41の番号に何も届かない場合は、コードを触る前に次の点を確認してください。

• 20分の待機時間をフルに使いましょう。プラットフォームによっては送信メッセージをキューに溜めます。
• そのサービスが仮想番号を拒否していないか確認してください。拒否するサービスは複数あり、まさにそのために自動返金の仕組みがあります。
• すぐに再注文を繰り返すのではなく、少し時間を置くか、別のサービスルートで試してください。
• 放置したアクティベーションはキャンセルし、すぐに返金されるようにします。

同じアプリでも国のルートによって挙動が異なる理由は、OTPの国別ルーティングの記事で解説しています。

スイスの長期利用番号はありますか?

セルフサービスの商品としてはありません。スイスについては、OTP RouteはOTP Gatewayによるワンタイム番号のみを提供しています。

更新し続ける限り保持できる専用バーチャル番号は、米国とカナダに限られ、月額$1.95から利用できます。スイスの固定回線番号が必要な場合は [email protected] まで用途を添えてご連絡ください。ただし、現地の規制次第であり、事前にお約束することはできません。

スイスのOTPルーティングにおけるウォレット、請求書、サンドボックス

お支払いは、単一のプリペイドUSDウォレットからの従量課金です。月額料金もプラン選択もありません。チャージはカードまたはUSDT/USDCで行え、チャージのたびにPDFの請求書がメールで届くため、スイスフランで精算するスイスの法人でも経理が整理しやすくなります。

連携作業のため、開発用アカウントにサンドボックスモードを依頼できます。シミュレートされた番号とコードが返されるので、ウォレット残高を使わずにSMS認証APIの全経路をテストできます。実際のアクティベーションは、自社のプロダクトとアカウントに対してのみ、各サービスの利用規約とOTP Routeの利用規定の範囲内でご利用ください。チームがこれをリリース前チェックに組み込む方法は、QAテスト向けソリューションのページをご覧ください。

よくある質問

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

スイスは ch です。国を指定する箇所では、アクティベーションのボディを含め、スイス向けのリクエストにこの2文字の値を使います。

スイスのSIMがなくても、スイスのログインフローを確認できますか?

はい。OTP Gatewayのテスト用+41番号でコードを受信し、ダッシュボードまたはAPIで確認できます。

スイスの携帯番号を保存するとき、先頭の0は残すべきですか?

いいえ。0は国内のトランクプレフィックスです。E.164形式、つまり +41 に9桁が続く形で保存してください。

スイスの認証SMSは何語で届きますか?

送信元によって異なり、ドイツ語、フランス語、イタリア語、英語のいずれもよくあります。固定の文言ではなく、数字パターンでコードを抽出してください。

スイスのSMS OTPはいくらですか?

1コード$0.20からで、サービスごとの正確な価格は注文前に GET /api/v1/prices で返されます。

コードが届かなかった場合、お金はどうなりますか?

待機時間が終了したとき、またはアクティベーションをキャンセルしたときに、自動的にウォレットへ戻ります。

リヒテンシュタインもスイスのルートでカバーされますか?

いいえ。リヒテンシュタインは独自の国番号+423を持ち、国一覧にも専用ページがあるため、別途ご注文ください。

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