日本語
エンドポイント、Webhook、ダッシュボードでチェコのSMS OTPコードを受信する
はい。OTP Routeでは、OTP Gatewayの使い捨て番号でチェコ(+420)のSMS認証コードを受信でき、ダッシュボードのほか、RESTポーリングや署名付きWebhookを通じて自社のコードにも届けられます。料金は$0.20/コードからで、20分の有効時間内にコードが番号に届いた場合にのみ課金されます。
チェコOTP APIはどのエンドポイントを使いますか?
すべてのリクエストは、or_live_で始まるBearerキーを付けてhttps://otproute.com/api/v1に送ります。キーはDeveloperコンソールで作成し、1アカウントにつき最大10個まで持てます。そのため、ステージング、CI、ローカルのノートPCにそれぞれ別の認証情報を割り当て、個別に失効させることが簡単にできます。レート制限は、アカウントあたり1分300リクエストです。
+420での典型的な実行手順は次のとおりです。
- デプロイごとに一度、
GET /api/v1/countriesとGET /api/v1/servicesを取得してキャッシュします。チェコの国IDはczです。 - 使う予定のルートのリアルタイム価格を
GET /api/v1/prices?country=cz&service=<id>で確認します。価格はサービスと在庫状況によって変わります。 POST /api/v1/activationsにJSONボディ{"service": "<id>", "country": "cz"}を送ってアクティベーションを作成します。レスポンスにはアクティベーションIDと、テスト中のサインアップフォームに入力する番号が含まれます。- Webhook、または適度な間隔での
GET /api/v1/activations/{id}の取得で、コードの到着を待ちます。 - テストを中断する場合は、
POST /api/v1/activations/{id}/cancelで番号を解放すると、保留分がすぐにウォレットへ戻ります。
大規模なテストスイートを始める前にGET /api/v1/balanceを呼んでおけば、残高不足を手軽に早期検出できます。詳しいリファレンスはドキュメントにあります。
+420のアクティベーションのWebhookはどう検証しますか?
Webhookを使えばポーリングが不要になり、並列のテストランナーにも向いています。エンドポイントの1つ(Developerコンソールでは1アカウントにつき5つまで)をチェコ向けのフローに割り当て、activation.sms_received、activation.expired、activation.cancelledを購読させます。
各リクエストには、t=<unix>,v1=<hex>という形式のX-OTPRoute-Signatureヘッダーが付きます。加工されていないリクエストのバイト列から<t>.<raw body>という文字列を組み立て、そのエンドポイントのシークレットでHMAC-SHA256を計算し、結果をv1と定数時間で比較します。タイムスタンプが古すぎて新しい配信とは言えないものは破棄してください。HMACによるOTP Webhookの保護のガイドでは、ハンドラーを1行ずつ解説しています。
イベントはアクティベーションIDをキーとして扱い、ハンドラーは冪等にしてください。再送された配信を受け取ったときは、アクティベーションがすでに完了済みになっていることを確認して、そのまま成功を返します。公開エンドポイントを置けない環境で動くスクリプトでは、GET /api/v1/activations/{id}のポーリングも有効な代替手段です。
チェコの番号にコードを送れるサービスはどれですか?
チェコのルートは現在、1,700を超えるサービスに対応しています。最新のスナップショットで人気のあるものは、WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、Microsoft & Outlook、LinkedIn、Discord、Uber、Airbnb、Signal、Viber、ChatGPT (OpenAI)です。
このリストは固定ではありません。在庫は日中に変動するため、コードにはハードコードした一覧表ではなく、実行時にAPIから取得した提供状況を使ってください。必要なサービスがある時点で見つからなくても、後で再び表示されることがあります。また、近隣の中欧のルートがテストケースに合う場合もあります。
チェコの認証用番号はどのように保存・解析すべきですか?
チェコの電話番号体系はクローズドプランで、国内番号は9桁、トランクプレフィックスはありません。そのため、国内表記と国際表記の違いは先頭の+420だけです。多くの国より正規化は簡単ですが、フォームにはスペース入りの入力、国際プレフィックスの00420、あるいは9桁だけの入力が届きます。区切り文字を取り除き、00を+に変換し、+420がなければ付け足して、E.164形式で保存してください。
チェコ向けアプリからのコードは、通常チェコ語か英語で届きます。チェコ語にはháčekやčárkaなどの発音記号があり、メッセージを基本的な文字セットに収めるために、送信側がこれらを外すこともあります。したがってパーサーは、文章全体を照合するのではなく、数字のまとまりを探すようにしてください。
チームが+420番号をテストに使うのは、チェコの顧客向けにプロダクトをローンチするとき、チェコ語のオンボーディング文言を確認するとき、先頭のゼロなしで番号を受け付ける地域向けサインアップフローを検証するときなどです。QAテストのページでは、こうしたテストランの組み立て方を説明しています。
チェコのコードが届かない場合はどうなりますか?
一部のサービスは仮想番号を受け付けず、時間帯によって遅くなるルートもあります。届かなかったコードに料金はかかりません。20分の有効時間内にSMSが届かなかった場合、またはその前にキャンセルした場合は、全額が自動的にウォレットへ戻ります。
- 失敗と判断する前に、有効時間いっぱいまで待ちます。
- テスト対象のサービスが、そもそも仮想番号を受け付けているかを確認します。
- 時間をおいて再試行するか、そのサービスが対応している別の国のルートを試します。
- 試行の間隔を空けてください。短い間隔で再注文を繰り返すとレート制限を消費するだけで、ほとんど効果がありません。
- 失敗のたびにアクティベーションIDをログに残しておくと、複数回の実行にまたがるパターンが見つかります。
開発者でなくても、ダッシュボードから+420のルートを使えますか?
はい。メールアドレスと6桁のメールコード(またはGoogleでのサインイン)でサインアップしたら、OTP Gatewayを開き、サービスとチェコを選び、表示された価格を確認して注文します。チェコの認証用番号がすぐに表示されるので、アプリに貼り付けると、SMSが届いた時点で同じ画面にコードが表示されます。ダッシュボードからのキャンセルでも、API呼び出しと同様に金額がウォレットに戻ります。
チェコの長期番号はありますか?料金の扱いは?
現在、チェコ向けのセルフサービスの長期番号はありません。専用番号(Dedicated Numbers)は米国とカナダ向けの製品で、1か月$1.95からです。SMSの送受信とブラウザからの通話に対応しており、詳細は仮想番号をご覧ください。+420の回線を継続して使いたい場合は[email protected]にメールでご相談ください。ただし、手配できるかどうかは現地の規制によるため、お約束はできません。
料金体系は、月額料金なし、プラン選択なしの前払いUSDウォレットが1つです。クレジットカード、またはUSDT/USDCでチャージでき、チャージのたびにPDFの請求書がメールで届きます。連携の開発中は、リクエストに応じて開発用アカウントをサンドボックスに切り替えられます。ウォレットの残高を使わずに、シミュレーションされた番号とコードでフロー全体をテストできます。アカウント自体には、TOTPによる二要素サインインも利用できます。
よくある質問
チェコのSIMがなくても、自社アプリのチェコ向けサインアップフローをテストできますか?
はい。テスト対象のサービス向けにOTP Gatewayで+420番号を注文し、アプリに入力して、ダッシュボード、API、またはWebhookからコードを読み取ります。
OTP Route APIでのチェコの国IDは何ですか?
POST /api/v1/activationsのcountryフィールドと、価格の照会にczを使います。
チェコの認証コードはいくらですか?
料金は1コード$0.20からです。サービスごとの正確な価格はGET /api/v1/pricesで返され、注文前に表示されます。お支払いはコードが届いた場合のみです。
チェコの番号には先頭の0が必要ですか?
いいえ。チェコの番号にはトランクプレフィックスがないため、+420に9桁の国内番号を続けた形で保存してください。
+420のアクティベーションはどのくらいの間有効ですか?
20分です。その間に何も届かなければアクティベーションは期限切れになり、ウォレットに全額が返金されます。
チェコ向けのOTPルーティングは、アカウントの大量作成に向いていますか?
いいえ。OTP Routeは、自社プロダクトのテストと、自社の正当なアカウントの運用のためのものです。+420のアクティベーションは、すべて自社のプロダクトやアカウントに紐づけ、各サービスの利用規約とOTP Routeの利用規定(Acceptable Use Policy)の範囲内で使ってください。
同じチェコの番号を、後のログインのために保持できますか?
セルフサービスの製品としては提供していません。長期の専用番号は米国とカナダのみで、その他の市場についてはサポートにメールでお問い合わせいただけます。
サービス名はそれぞれの所有者の商標です。OTP Route はこれらの企業と提携していません。番号は合法的にご利用いただき、各サービスの利用規約および当社の利用規定に従ってください。