ポーランド(+48)認証コード:チェックリスト、API手順、対処法

事前準備:ポーランドのサインアップをテストする前に何が必要ですか?

このリストを一度確認しておけば、最初のポーランド向け注文は何事もなく終わることがほとんどです。

1. 認証情報。 開発者コンソールでBearerキー(or_live_ で始まります)を生成します。ステージング、CI、本番で別々のキーを用意しておくと、ローテーションが楽になります。
2. 識別子。 ポーランドは pl です。サービスIDは、表示名を固定で埋め込まず、GET /api/v1/services から取得します。
3. 資金。 ウォレットにチャージします。価格は注文前に確認できます。
4. 配信先。 HTTPSのWebhookを登録し、そのシークレットはソース管理に含めないでください。受信トラフィックがブロックされている場合は、ポーリングでも動作します。
5. レート予算。 APIはアカウントあたり毎分300リクエストまでなので、並列スイートはそれに合わせて制限してください。
6. 対象範囲。 認証するのは、ご自身のプロダクト、会社、クライアントに属するアカウントのみとし、各サービスの規約と利用規定(Acceptable Use Policy)に従ってください。

パイプラインについては、とくにCIパイプラインでのSMS OTPテストをご覧ください。

現在、+48番号にコードを送るサービスは何ですか?

OTPルーティングにおいて、ポーランドはカタログの中でも幅広い国のひとつで、2,300を超えるサービスをカバーしています。人気のものの現在のスナップショットには、Facebook、Instagram、TikTok、WhatsApp、Telegram、Viber、Signal、Snapchat、Discord、X(Twitter)、LinkedIn、Google(Gmail & YouTube)、Amazon、AliExpress、Uber、Netflixが含まれています。

この一覧は約束ではなく、出発点として扱ってください。どのルートでも空き状況は一日の中で変わるため、注文のたびに価格エンドポイントで、その特定の組み合わせを確認してください。

ポーランド OTP APIの具体的な手順は何ですか?

https://otproute.com/api/v1 のSMS認証APIを使う場合、自動テストは次のように動きます。

1. GET /api/v1/prices?country=pl&service=<id> で、ポーランドでのそのサービスの現在の価格を確認します。
2. POST /api/v1/activations に {"service": "<id>", "country": "pl"} を渡すと、+48の番号とアクティベーションIDが返ります。
3. テストがその番号をサインアップフォームに入力し、SMSをリクエストします。
4. ハンドラーが activation.sms_received を受け取ります。activation.expired または activation.cancelled を受け取った場合は、その実行を未配信としてマークします。
5. Webhookがない場合は、コードが現れるかウィンドウが終わるまで、数秒おきに GET /api/v1/activations/{id} を読み取ります。
6. テストが早く終了した場合は、POST /api/v1/activations/{id}/cancel を呼びます。

ペイロードを信頼する前に、X-OTPRoute-Signature ヘッダーを検証してください。ヘッダーには t=<unix>,v1=<hex> が入っており、v1 はエンドポイントのシークレットで署名した <t>.<raw body> のHMAC-SHA256です。タイムスタンプが古いものは拒否し、ハンドラーはアクティベーションIDに対して冪等にしてください。検証の詳細はWebhookセキュリティガイドで紹介しています。

オペレーションチームは、APIなしでポーランドの番号を注文できますか?

はい。OTP Routeのダッシュボードで、OTP Gatewayを開き、ポーランドを選び、サービスを検索して、表示された価格を確認します。注文後、ポーランドの認証用番号をアプリの認証画面にコピーし、アクティベーションカードを見ていれば、SMSの本文が届いた時点でそこに表示されます。インストールするものは何もなく、同じウォレットがブラウザとAPIの両方の費用に充てられます。

ポーランドの番号とメッセージの扱いは、何が違いますか?

ポーランドはトランクプレフィックスのない閉鎖型番号計画を採用しており、携帯でも固定でも、すべての番号は+48の後に9桁です。そのため、検証は心地よいほど厳格にできます。国内の9桁に縮約できない入力は拒否し、ユーザーが3桁ずつ区切って入れるスペースやダッシュは取り除き、+48 と9桁を1つのE.164文字列として保存してください。先頭に紛れ込んだゼロは、保持すべきプレフィックスではなく、入力ミスです。

アカウントの言語がポーランド語だと、認証メッセージはポーランド語で届くことがよくあります。ą、ę、ł、żなどの文字はGSM 7ビットアルファベットの範囲外にあるため、自社でポーランド語のOTPテキストを送る場合は、セグメントが短くなることを想定し、テンプレートが実機でどう表示されるかをテストしてください。届いたコードを解析するときは、数字に注目し、周囲の言葉は無視します。

ここでテストする主な理由には、ポーランド市場に参入するプロダクト、ポーランド語フローのローカライズQA、中央ヨーロッパ全域の事業用アカウントを担当する地域チーム、そしてEU内の別の国に住むポーランド語話者を顧客に含むアプリがあります。

トラブルシューティング:+48のコードが届かないのはなぜですか?

• ウィンドウがまだ開いている。 何かを結論づける前に20分をフルに待ってください。課金されるのはコードが届いた場合のみです。
• サービスが仮想番号を拒否している可能性がある。 そうするプラットフォームもあり、その場合は自動返金で全額がウォレットに戻ります。
• ルートが混み合っている。 時間をおいて再試行するか、別のサービスのルートをテストしてください。
• テストがループしている。 数秒おきに再注文するとリクエスト予算を使い果たすので、バックオフを入れてください。

ほかのパターンはOTP配信失敗の削減にまとめています。

ポーランドに専用番号はありますか?支払いはどうなりますか?

セルフサービスの製品としてはありません。専用の仮想番号(Dedicated Virtual Numbers)は、アメリカとカナダのみで、月額$1.95からです。ポーランドの長期回線については、[email protected]にメールしてお尋ねください。可能かどうかは現地の規制で決まるため、提供をお約束するものではありません。

支払いは、プランも月額料金もない1つの前払いUSDウォレットで行い、カードまたはUSDT/USDCでチャージでき、チャージごとにPDFの請求書がメールで届きます。開発者は、連携を構築している間、開発用アカウントでサンドボックスモードを依頼して、シミュレーションされた番号とコードを受け取れます。最新のレートは料金をご覧ください。

よくある質問

チームの誰も+48のSIMを持っていない場合、ポーランドのサインアップフローをテストするにはどうすればよいですか?

OTP Gatewayでテスト用の+48番号を注文し、フローで使ってください。コードはダッシュボードに表示され、Webhookに送信することもできます。

OTP Route APIの呼び出しでのポーランドの国コードは何ですか?

pl で、POST /api/v1/activations と価格の問い合わせの両方で使います。

ポーランドの電話番号は何桁ですか?

+48の後に国内の9桁で、トランクのゼロはありません。この固定長のおかげで、サーバー側の検証がシンプルになります。

ポーランドのSMS OTPを受信するにはいくらかかりますか?

料金は1コード$0.20〜で、サービスによって異なります。正確な金額は、注文前にダッシュボードと価格エンドポイントで確認できます。

ポーランドのアクティベーションが空のまま期限切れになった場合、損をしますか?

いいえ。コードが届かずに終了したアクティベーションや、キャンセルしたアクティベーションは、ウォレットに全額返金されます。

本番前に、ポーランドのフロー全体をシミュレーションできますか?

はい。開発用アカウントでサンドボックスモードを依頼すれば、ウォレットの資金を使わずに、シミュレーションされた番号とコードを受け取れます。

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