ポルトガル展開のための、+351認証コードのプログラム受信

+351の認証実行で使うエンドポイントはどれですか?

ベースURLは https://otproute.com/api/v1 で、すべてのリクエストに or_live_ で始まるBearerキーを付けます。ポルトガルの国IDは pt です。

1. GET /api/v1/countries と GET /api/v1/services でIDを取得します。テスト実行ごとにキャッシュしてください。
2. GET /api/v1/prices?country=pt&service=<id> で、現在の価格とルートが開いているかどうかが分かります。
3. POST /api/v1/activations に {"service": "telegram", "country": "pt"} を送ると、番号が確保され、アクティベーションIDが返ります。
4. ポーリングを使う場合は、GET /api/v1/activations/{id} でステータスとコードを確認します。
5. テストで不要になった番号は、POST /api/v1/activations/{id}/cancel で解放します。
6. GET /api/v1/balance を使えば、ウォレット残高が少ないときにパイプラインを早めに止められます。

アカウントの上限は、APIキー10個、Webhookエンドポイント5つ、毎分300リクエストです。スキーマの詳細はAPIリファレンスをご覧ください。

署名付きWebhookでポルトガルのコードを自社サービスに届けるには?

Developerコンソールでhttpsのエンドポイントを登録し、activation.sms_received、activation.expired、activation.cancelled を購読します。各POSTには X-OTPRoute-Signature: t=<unix>,v1=<hex> が含まれます。

検証するには、<t>.<raw body> という文字列を組み立て、エンドポイントのシークレットでHMAC-SHA256を計算し、v1 と定数時間で比較します。タイムスタンプが古すぎるリクエストは拒否してください。そうすれば、盗まれたリクエストを再送されても通りません。各イベントのアクティベーションIDを保存し、重複したものは無視すれば、配信が再試行されても安全に処理できます。手順はWebhookベースのコード取得で順を追って解説しています。

ポルトガルのルートで利用できるサービスは?

現在のスナップショットでは、ポルトガルで2,000を超えるサービスが利用できます。よく使われるものには、WhatsApp、Telegram、Airbnb、Uber、Google(Gmail & YouTube)、Facebook、Instagram、TikTok、LinkedIn、Microsoft & Outlook、Amazon、Netflix、Discord、Signalがあります。

この一覧は、キャリアパートナーの容量の変動に応じて1日の中で変わります。だからこそ、テストを実行するかどうかは、固定の設定ファイルではなくpricesエンドポイントで判断してください。

プロダクトチームがポルトガルの番号でテストするのはなぜですか?

ポルトガルは、EU展開の計画で早い段階に登場することがよくあります。リスボンとポルトには多くのプロダクトチームやエンジニアリングチームが集まっており、ヨーロッパの拠点にポルトガルを選ぶ企業も少なくありません。ローカライズ上の理由もあります。ヨーロッパのポルトガル語(pt-PT)は、綴り、語彙、呼びかけの形式がブラジルのポルトガル語と異なるため、ブラジル向けに翻訳したフローは、ポルトガルのユーザーには不自然に読めることがあります。実際の+351番号で認証を行えば、レビュアーはpt-PTの文言、届くSMS、前後の画面をまとめて確認できます。

GDPRの観点でも、テスト用アカウントや共有アカウントにスタッフの電話番号を置かないことは、データ最小化の良い実践です。確認ごとに使い切りの番号を使えば、QAシステムに残る個人識別子が減ります。CIパイプラインガイドでは、これを毎回のビルドに組み込む方法を紹介しています。

+351の番号はどのように書式化して保存しますか?

ポルトガルには国内プレフィックス(先頭の0)がありません。番号は9桁で、国内でも国際形式の +351 の後でも同じようにダイヤルします。携帯電話は 9 で始まり、固定電話は 2 で始まります。番号はE.164形式で保存し、国番号の後が9桁でないものは拒否し、ユーザーが3桁ごとに区切って入力したスペースは取り除いてください。

届くコードの言語は、送信元とアカウントの言語設定によって、ポルトガル語または英語になるのが一般的です。コードの抽出処理は、決まった文言ではなく数字を探すようにしてください。

コードなしでも使えますか?SMSが届かない場合はどうなりますか?

ダッシュボードでOTP Gatewayを開き、ポルトガルとサービスを選び、最新の価格を確認して注文します。番号をアプリに貼り付け、アクティベーションのページでコードを待ちます。

有効時間は20分で、課金されるのはコードが届いたときだけです。届かなければ、全額が自動的にウォレットへ戻ります。コードが見当たらないときは、次を試してください。

• 数秒でキャンセルせず、有効時間が終わるまで待ちます。
• そのフローで、サービスが仮想番号を受け付けるか確認します。
• 時間を置いて再試行するか、別のサービスルートで同じ画面をテストします。
• 短い間隔で再注文を繰り返さず、試行の間隔をあけます。

ポルトガルの専用番号はありますか?料金の仕組みは?

OTP Routeでは、ポルトガルのセルフサービス専用番号は販売していません。Dedicated Virtual Numbersは米国とカナダのみで、月額$1.95からです。+351の長期回線が必要な場合は、[email protected] までメールでご相談ください。ただし、提供の可否は現地の規則によるため、確約はできません。一時番号と専用番号の違いもあわせてご覧ください。

お支払いは、プリペイドのUSDウォレットによる従量課金で、月額料金やプランはありません。カード、またはUSDT/USDCでチャージでき、チャージごとにPDFの請求書が届きます。開発アカウントは、リクエストに応じてサンドボックスに切り替えられ、シミュレートされた番号とコードでテストできます。各サービスの利用規約を守ってください。OTP Routeの利用規定(Acceptable Use Policy)も適用されます。

よくある質問

OTP Route APIでのポルトガルの国IDは何ですか?

pt です。pricesのクエリでも、アクティベーションのリクエストボディでも、この値を使います。

ポルトガルの電話番号には、先頭の0のような国内プレフィックスがありますか?

ありません。ポルトガルの番号は国内プレフィックスのない9桁なので、E.164形式は +351 の後にその9桁が続きます。

ポルトガルのSIMカードなしで、pt-PTのオンボーディングフローをテストできますか?

はい。OTP Gatewayのテスト用+351番号がコードを受信し、ダッシュボードまたはAPIで読み取れます。

ポルトガルの認証用番号はいくらですか?

1コード$0.20からです。正確な価格はサービスによって異なり、注文前に表示されます。

何も届かなかった+351のアクティベーションにも料金がかかりますか?

いいえ。期限切れまたはキャンセルされたアクティベーションは、ウォレットに全額返金されます。

継続的なログイン用に、ポルトガルの番号をレンタルできますか?

セルフサービスでは提供していません。長期回線は米国とカナダ向けの製品です。+351の回線が必要な場合は、サポートまでメールでお問い合わせください。

ポルトガルのコードは、ポーリングとWebhookのどちらで受け取るべきですか?

並列ジョブにはWebhookのほうが向いています。受信リクエストを受け付けられないランナーには、GET /api/v1/activations/{id} のポーリングが適しています。

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