パラグアイ(+595)認証コード、API優先で

コードで+595の番号をリクエストするにはどうすればよいですか?

開発者コンソールでBearerキーを作成するところから始めます。キーは or_live_ で始まり、最大10個まで保持できるため、ステージング用とCI用で別々のキーを用意するのも簡単です。すべての呼び出しは https://otproute.com/api/v1 に送ります。

1. GET /api/v1/services と GET /api/v1/countries でカタログをキャッシュします。パラグアイは py として登場します。
2. 注文の前に毎回、GET /api/v1/prices?country=py&service=<id> を読み取ります。価格と空き状況は定数ではなくリアルタイムの値です。
3. POST /api/v1/activations に {"service": "whatsapp", "country": "py"} を渡して注文します。レスポンスのアクティベーションIDは保管してください。
4. テスト対象のフローにその番号を入力します。
5. Webhookを待つか GET /api/v1/activations/{id} を確認します。テストが早く終わった場合は POST /api/v1/activations/{id}/cancel を呼びます。

GET /api/v1/balance はパイプラインの事前チェックに役立ち、ウォレットが空のときにジョブがタイムアウトではなく、はっきりと失敗するようになります。同じ呼び出しをより詳しい文脈で解説したのが連携ガイドです。

Webhookハンドラーはパラグアイのコードをどう扱うべきですか?

エンドポイントは、メッセージが届いたときに activation.sms_received、ウィンドウが空のまま閉じたときに activation.expired、キャンセル後に activation.cancelled を受け取ります。どれもアクティベーションIDに紐づいています。

• 最初に検証する。 X-OTPRoute-Signature を t と v1 に分割し、エンドポイントのシークレットで、タイムスタンプ、ドット、生のリクエストボディのHMAC-SHA256を計算し、定数時間で比較します。
• 古いリクエストを拒否する。 自分の時計から大きく離れたタイムスタンプは、リプレイ攻撃か、サーバーの時刻が大きくずれていることを意味します。
• 冪等にする。 アクティベーションIDを保存して重複を無視すれば、再試行された配信でコードが二重処理されることはありません。

Webhookエンドポイントは、アカウントあたり最大5つまで利用できます。ポーリングを選ぶ場合は、間隔を控えめにしてください。上限はアカウント全体で毎分300リクエストです。より詳しいチェックリストはHMAC Webhookガイドにあります。

パラグアイのルートで利用できるサービスは何ですか?

パラグアイでは現在、1,600を超えるサービスを利用できます。特にリクエストの多いものとして、WhatsApp、Instagram、Telegram、Uber、Facebook、TikTok、Google(Gmail & YouTube)、Microsoft & Outlook、X(Twitter)、Discord、LinkedIn、Netflix、ChatGPT(OpenAI)があります。WhatsAppはこの地域の多くの人にとって日常的なメッセンジャーなので、チャットベースのサポートをテストするチームが最初に認証するサービスになることがよくあります。

+595の携帯番号はどう表記され、どう正規化しますか?

パラグアイは国内ダイヤルにトランクプレフィックスの0を使うため、現地で目にする携帯番号は09で始まります。E.164ではその0が取れ、正規形は+595に9桁が続く形で、携帯は9から始まります。入力時に正規化し、E.164形式のみを保存し、表示用のフォーマットは画面の端で行ってください。ほかの国の固定桁数を前提にしたバリデーションルールは、パラグアイのユーザーが登録に失敗する一般的な原因なので、検証のテストケースには+595の番号を含めてください。

スペイン語とグアラニー語はどちらも公用語です。国際的なサービスからの認証メッセージは、テンプレートやアカウント設定によって、スペイン語か英語で届く傾向があります。コードは数字のみのパターンで解析し、メッセージ本文はUTF-8で保持して、アクセント付き文字やñがログでも失われないようにしてください。

なぜチームはパラグアイでアカウントを認証するのですか?

パラグアイはメルコスールの一員で、アルゼンチン、ブラジル、ボリビアに挟まれているため、すでにこの地域で事業を行っている企業が、南米展開の一環として追加することがよくあります。そこでテストする典型的な理由は、パラグアイのユーザー向けのスペイン語ローカライズQA、地域のオンボーディングフローが+595番号を受け付けることの確認、現地のクライアント向けにビジネスプロフィールを認証するオペレーションチーム、そして母国の番号で登録する海外在住のパラグアイ人へのサポートなどです。こうした確認がリリーステストにどう収まるかは、モバイルアプリ認証のページで説明しています。

ノーコードでパラグアイの認証用番号を取得する方法はありますか?

はい。ダッシュボードでOTP Gatewayを開き、パラグアイとサービスを選んで、価格を確認し、確定します。番号をアプリにコピーし、その横にコードが表示されるまでアクティベーションを開いたままにしておきます。ブラウザからの注文とAPIからの注文は、同じウォレットと履歴を使います。

+595のコードが表示されない場合は、どうすればよいですか?

結論を出す前に、アクティベーションの20分のウィンドウをフルに待ってください。何も届かないまま閉じた場合は、料金が自動的に戻ります。そのうえで、よくある原因を順に確認します。サービスが仮想番号を拒否している、その時間帯はルートが混雑している、別のサービスのルートなら後で成功する、といったことが考えられます。短い間隔で繰り返し注文しないでください。試行の間にはバックオフを入れ、アクティベーションIDを記録して、サービスごとのパターンを見つけられるようにしましょう。

パラグアイの番号を長期間保持できますか?課金はどうなっていますか?

パラグアイでは、セルフサービスの長期回線は販売していません。専用の仮想番号(Dedicated Virtual Numbers)はアメリカとカナダのみで、月額$1.95からです。そのため、継続してログインが必要なアカウントは、代わりにそのどちらかの番号に置かれることがよくあります。パラグアイの長期回線について尋ねる場合は、[email protected]までメールしてください。回答は現地の規制によります。

課金は1つの前払いUSDウォレットで行います。カードまたはUSDT/USDCでチャージし、PDFの請求書がメールで届き、実際に届いたコードの分だけ支払います。開発用アカウントは依頼によりサンドボックスに切り替えられ、シミュレーションされた番号とコードが使えます。OTP Routeは、ご自身の正当なプロダクトのテストと運用のためのものです。各サービスの規約と利用規定(Acceptable Use Policy)に従ってください。

よくある質問

OTP Route APIでのパラグアイの国IDは何ですか?

py です。価格の問い合わせと、POST /api/v1/activations のボディで使います。

パラグアイの番号は、09プレフィックス付きで保存しますか?

いいえ。国内の0を取り除き、+595に9桁の国内番号を続けた形で保存してください。

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

パラグアイのアクティベーションは、サービスによって1コード$0.20〜で、実際にコードが届いた分だけウォレットから引き落とされます。

現地のSIMなしで、パラグアイ向けのスペイン語サインアップフローをテストできますか?

はい。OTP Gatewayでパラグアイの認証用番号を注文し、ダッシュボードまたはAPIでコードを読み取ってください。

コードはグアラニー語で届きますか?

届くことはまれで、ほとんどありません。国際的なサービスは通常スペイン語か英語のテキストを送るので、数字だけを解析してください。

アクティベーションが期限切れになった場合、お金はどうなりますか?

20分のウィンドウ内にSMSが届かなかった場合、全額が自動的にウォレットへ戻ります。

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