+90番号でトルコの認証テストを行う手順をステップごとに解説

事前準備:+90番号をリクエストする前に何を用意すべきですか?

トルコ向けのテスト計画を本番で動かす前に、次のチェックリストを確認しておくと、無駄なアクティベーションを減らせます。

1. GET /api/v1/services でアプリのサービスidを調べ、GET /api/v1/countries で国id tr を確認します。
2. GET /api/v1/prices?country=tr&service=<id> を呼び、その組み合わせの現在の料金と利用可否を確認します。
3. GET /api/v1/balance で、ウォレット残高がテスト実行分をまかなえるか確認します。
4. Webhookエンドポイントを登録し(1アカウントにつき最大5つ)、シークレットはソース管理に含めないようにします。
5. 電話番号の検証ライブラリのリージョンをTRに設定し、テスターに番号をどう表示し直すかを決めます。
6. テスト環境にトルコ語ロケールを読み込みます。大文字小文字まわりの文字列バグは、ここで最初に見つかることが多いためです。

先頭の0がトルコの電話番号検証でつまずきやすいのはなぜですか?

トルコ国内では携帯番号を0 5XX XXX XX XXのように、トランク接頭辞付きで書きます。国際形式ではこの0が消え、正規の形は+90に10桁の国内番号を続けたものとなり、携帯番号は国番号の後に5で始まります。

両方の書き方を受け付けるフォームには、正規化の処理が必要です。スペースや記号を取り除き、リージョンがTRのときは先頭の 0 を1つ削除して +90 を付け、E.164形式(+905…)で保存します。保存値にトランクの0を残してはいけません。残すと、同じテスターがデータベース上で別々のユーザーに見えてしまいます。トルコのユーザーが国内形式に慣れている場合は、表示時にだけ国内形式に戻してください。

トルコ語の認証SMSは、パーサーにとってどのように見えますか?

トルコ語が公用語で、現地の送信元はç、ş、ğ、ı、ö、üといった文字を使ったトルコ語でコードを書きます。海外のアプリは、端末やアカウントの言語に従うのが一般的です。どちらの場合でも、周囲の単語ではなく数字のパターンでコードを抽出してください。

トルコ語ロケールには、よく知られたソフトウェア上の落とし穴もあります。小文字のiを大文字にするとドット付きのİになり、Iを小文字にするとドットなしのıになります。ロケール依存の大文字小文字変換で文字列を比較するコードは、トルコのユーザーに対してログインやメールの照合を壊すことがあります。+90のテストは、これに加えて桁数に合った入力マスクや翻訳済みエラーメッセージを確認する良い機会です。関連するチェック項目はモバイルアプリ認証ガイドで扱っています。

どのアプリのコードをトルコの認証用番号で受信できますか?

tr の現在のスナップショットには、WhatsApp、Telegram、Instagram、TikTok、X (Twitter)、Google (Gmail & YouTube)、Microsoft & Outlook、LinkedIn、Uber、Netflix、AliExpress、Discord、ChatGPT (OpenAI)、Amazonが含まれます。トルコのルート全体では、1,800を超えるサービスに対応しています。

ここで注文するのは、トルコ向け製品のローンチ、マーケティング施策前のローカライズ確認、ヨーロッパ各地に住むトルコ語圏の顧客への対応などの場面です。提供状況は一日の中で変動するため、テスト設定に固定リストを持たせず、ライブの料金一覧を参照してください。

APIでトルコのOTPをリクエストして読み取るにはどうしますか?

呼び出しの流れは短くまとまっています。接頭辞が or_live_ のBearerキーを付けて、{"service": "<id>", "country": "tr"} を POST /api/v1/activations に送ります。返ってきた+90の番号を、テスト対象のアプリに入力します。SMSが届くと、OTP Routeがエンドポイントへ activation.sms_received を送ります。先にウィンドウが閉じた場合は activation.expired、手動で停止した場合は activation.cancelled が届きます。

イベントを信頼する前に、X-OTPRoute-Signature ヘッダーから署名を再計算してください。タイムスタンプ、ドット、生のリクエストボディをつなげたものに、エンドポイントのシークレットでHMAC-SHA256をかけます。古いタイムスタンプのものは拒否し、同じアクティベーションidに対する重複配信は1件のイベントとして扱います。外向きのHTTPを受け付けられない環境では、GET /api/v1/activations/{id} のポーリングが代替手段になります。より詳しくは、WebhookによるOTP取得の記事と開発者ハブをご覧ください。

コードを書くより操作したい場合は?ダッシュボードを使いましょう

技術に詳しくないメンバーも、ブラウザ上で同じ流れをたどれます。サインインして残高をチャージし、サービスとトルコを選んで、+90の番号をアプリにコピーします。届いたSMSは、アクティベーションのカードに表示されます。一時番号は、20分のウィンドウの間、1回分のコードを受け取るために使えます。

トルコのコードが届かないときはどうすればよいですか?

• 失敗と判断する前に、20分間をフルに待ちます。
• アプリが仮想番号を受け付けるか確認します。拒否するものもあり、自動返金はそのような場合のためにあります。
• 少し時間をおいて再試行するか、テストの内容が許すなら別のサービスルートを試します。
• 再試行は間隔をあけ、連続して注文を繰り返さないでください。

コードが届かずに終わった注文には費用がかかりません。全額がウォレットに戻ります。

請求、サンドボックス、長期番号について教えてください

OTP Routeは、プランを選ぶ必要のないプリペイドのUSDウォレットで動きます。チャージはカードとUSDT/USDCのどちらにも対応し、チャージのたびにPDFの請求書がメールで届きます。開発者は、開発用アカウントをサンドボックスに切り替えるよう依頼できます。サンドボックスでは、残高を使わずにエンドツーエンドのテストができるよう、模擬の番号とコードが返されます。

セルフサービスで使えるトルコの長期番号はありません。必要な場合は [email protected] にメールでご相談ください。可否は現地の規制によります。継続して更新する回線には、アメリカとカナダ向けの専用番号が月額$1.95から提供されています。

よくある質問

トルコのSIMカードなしで、アプリのトルコ向けサインアップを検証できますか?

はい。OTP Gatewayの一時的な+90番号でコードを受信でき、ダッシュボードまたはAPIで読み取れます。

トルコの番号は先頭の0を付けて保存すべきですか?

いいえ。E.164形式で、+90に10桁の国内番号を続けて保存してください。トランクの0は、国内形式で表示するときにだけ付けます。

トルコのAPI国idは何ですか?

tr です。POST /api/v1/activations の country フィールドと、料金の問い合わせに指定します。

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

トルコでのアクティベーションは1コード$0.20からで、アプリごとに料金が異なります。注文前にダッシュボードと GET /api/v1/prices で確認できます。

コードが配信されなかった場合はどうなりますか?

20分以内にSMSが届かなかった場合、またはアクティベーションをキャンセルした場合は、全額がウォレットに返金されます。

トルコの番号を、後日のログインのために保持できますか?

セルフサービスでは提供していません。[email protected] にメールでお問い合わせください。ご利用可否は現地の規則によります。

番号の使い方にルールはありますか?

はい。トルコの番号は、ご自身のものであるプロダクトやアカウントのテストと運用のためのものです。各アプリの利用規約と、OTP Routeの利用規定(Acceptable Use Policy)も適用されます。

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