+357認証番号で、キプロスの登録フローをテストする

チームはキプロス向けにリリースしますが、現地のSIMがありません。どんな選択肢がありますか?

よくあるパターンは次のようなものです。ニコシア、リマソール、ラルナカの顧客向けにプロダクトを公開し、オンボーディングの電話番号ステップに回帰テストが必要になりますが、手元にある+357のSIMは、個人の携帯からコードを転送し続けて疲れた同僚2人のものだけです。引き出しの中の物理SIMは、失効したり、なくなったり、誰も覚えていないテストアカウントに紐づいたままになったりします。

OTPルーティングは、その引き出しの代わりになります。テストハーネスは実行ごとに新しいキプロスの番号をリクエストし、コードを待って次に進みます。端末は不要です。キプロスで登録された事業用アカウントを、誰かの私用の携帯を使わずに認証しなければならない運用チームにも、同じ方法が使えます。チームが既存のスイートにこれを組み込む方法は、QAテストガイドで紹介しています。

キプロスはEU加盟国で、ソフトウェア、フィンテック、海運が盛んなため、すでにギリシャや東地中海で事業を行っている企業にとって、ヨーロッパでの最初か2番目の市場になることがよくあります。

キプロスの番号にコードを送信できるアプリは何ですか?

キプロスのライブスナップショットには、現在1,500を超えるサービスが掲載されています。チームから特に要望が多いものは次のとおりです。

• メッセージング:WhatsApp、Viber、Telegram、Signal
• 業務アカウント:Google (Gmail & YouTube)、Microsoft & Outlook、LinkedIn
• ソーシャルログイン:Facebook、Instagram、TikTok
• 旅行・コマース:Uber、Airbnb、Amazon、Netflix、eBay

個々のルートの利用状況は1日を通して変わるため、料金や対応状況はページに載せるのではなく、ライブで提供しています。上の一覧は出発点と考え、テストのスクリプトを組む前に、ダッシュボードまたはAPIで正確なサービスを確認してください。

キプロスOTP APIで+357番号をリクエストするには?

開発者コンソールでキーを作成します。キーはor_live_で始まり、https://otproute.com/api/v1に対するBearerヘッダーに指定します。典型的な実行は4回の呼び出しで済みます。

1. GET /api/v1/prices?country=cy&service=viberが現在の価格を返すので、ジョブは、設定した予算を超える場合に処理を中止できます。
2. POST /api/v1/activationsに{"service": "viber", "country": "cy"}を付けて送ると、番号が確保され、アクティベーションIDが返されます。
3. テストは、その番号をテスト対象のアプリに入力し、その後GET /api/v1/activations/{id}をポーリングするか、activation.sms_receivedのWebhookを待ちます。
4. シナリオが早い段階で失敗した場合は、POST /api/v1/activations/{id}/cancelで解放し、資金を戻します。

WebhookにはX-OTPRoute-Signatureヘッダー(t=<unix>,v1=<hex>)が付いています。受信側は、そのエンドポイントのシークレットを使って<t>.<raw body>のHMAC-SHA256を再構成し、途中で打ち切らずにv1と照合して、タイムスタンプが古すぎるリクエストは無視してください。キャパシティの計画のために、1アカウントでキーは最大10個、Webhookエンドポイントは5つまで保持でき、上限は毎分300リクエストです。すべてのフィールドはAPIドキュメントに載っています。

開発者でない人も、キプロスの認証番号を注文できますか?

はい。サポート担当者やアカウントマネージャーは、コードが1つだけ必要なことが多く、ダッシュボードならAPIに触れずに対応できます。

1. サインインして、OTP Gatewayを開きます。
2. キプロスを選び、次に認証したいサービスを選びます。
3. 表示される価格を確認します。これはAPIが返すのと同じ金額です。
4. 注文して、+357番号をアプリにコピーし、タブを開いたままにします。
5. コードは、受信するとすぐにアクティベーションカードに表示されます。

アクティベーションは20分間有効です。コードが不要になった場合は、同じカードからキャンセルできます。

コードが届きませんでした。どうすればよいですか?

失うものはありません。SMSが届かないまま20分のウィンドウが閉じた場合や、キャンセルした場合は、全額が自動的にウォレットに戻ります。次回の成功率を上げるために、次の点を試してください。

• 最初のウィンドウが終わるまで待ってから、再び注文する。同じサービスに対する重複したリクエストは、ほとんど役に立ちません。
• サービスによっては仮想番号を完全に拒否するため、コードが届かないのはルーティングの問題ではなく、先方のポリシーによる判断かもしれません。
• 少し時間を置いて再試行するか、同じフローを別のサービスルートでテストして、自社のコードパスが動作することを確認する。
• CIから短い間隔で再注文しない。試行の間隔を空け、実行ごとの再試行回数に上限を設ける。

再試行の予算については、OTP配信失敗を減らすためのガイドの記事でさらに詳しく解説しています。

+357番号はどのように保存すべきですか?また、コードは何語で届きますか?

キプロスにはトランクプレフィックスがないため、取り除くべき先頭のゼロはありません。国内番号は8桁で、携帯番号は9で始まります。E.164では、+357にその8桁を続け、スペースや句読点は入れません。ユーザーは最初の2桁の後にスペースを入れた国内形式で入力することがよくあるため、比較や保存の前に、空白を取り除いて国番号を付ける形で入力を正規化してください。

公用語はギリシャ語とトルコ語で、ビジネスでは英語も広く使われています。実際には、認証SMSの文言はアプリの言語設定に従うため、英語かギリシャ語のテキストが届くと考えてください。決まった文に一致させるのではなく、パーサーに数字の並びを抽出させれば、ロケールを切り替えても同じテストが動き続けます。

キプロスの長期回線はありますか?また、課金はどうなっていますか?

キプロス向けのセルフサービスの長期番号はありません。月々保持できるDedicated Numbersはアメリカとカナダ向けの製品で、月額$1.95からです。詳しくは仮想番号のページをご覧ください。継続して使える+357回線が必要な場合は、[email protected]にメールしてください。提供の可否は現地の規制によるため、お約束はできません。

課金は、月額料金もプランの選択もない、前払いのUSDウォレット1つで行われます。チャージはカードまたはUSDT/USDCで行え、チャージのたびにPDF請求書がメールで届きます。連携作業では、開発用アカウントにサンドボックスを依頼してください。シミュレートされた番号とコードが返されるため、ウォレットの資金を使わずにパイプラインをエンドツーエンドで実行できます。現在のモデルは料金をご覧ください。また、各サービスの利用規約とOTP Routeの利用規定(Acceptable Use Policy)は、すべてのアクティベーションに適用されます。

よくある質問

キプロスのSIMカードなしで、アプリのキプロス向け登録フローをテストできますか?

はい。OTP Gatewayから+357番号をリクエストし、アプリに入力して、ダッシュボードまたはAPIでコードを読み取ります。端末も現地のSIMも不要です。

APIでは、キプロスにどの国IDを指定しますか?

料金とアクティベーションのリクエストでは、国の値としてcyを使います。たとえば{"service": "whatsapp", "country": "cy"}のようにします。

キプロスのコードが届かなかった場合、課金されますか?

いいえ。SMSが届かずに終了したキプロスのアクティベーションは、20分でタイムアウトした場合も、ご自身でキャンセルした場合も、全額がウォレットに返金されます。

キプロスの番号から、先頭のゼロを取り除くべきですか?

キプロスはトランクプレフィックスを使わないため、取り除くものはありません。番号は+357に8桁の国内番号を続けた形で保存してください。

来月のログインに、同じ+357番号を再利用できますか?

いいえ。OTP Gatewayの番号1つで受け取れる認証コードは1回分です。繰り返しログインが必要なアカウントには、アメリカまたはカナダのDedicated Numberのほうが適しています。

キプロスの認証番号はいくらですか?

+357番号の料金は1コード$0.20 からで、最終的な金額は選んだサービスによって決まります。スクリプトはGET /api/v1/pricesから現在のキプロスの金額を読み取れ、ダッシュボードでは注文ボタンの横に表示されます。

OTP Routeは、大量のアカウントを開設するためのものですか?

いいえ。自社プロダクトのテストと、正当な事業用アカウントの運用のために作られています。各サービスの利用規約を守り、実在する個人または事業者ごとに1アカウントとしてください。

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