アルゼンチン(+54)の認証コードを自社の連携に取り込む

+54のアクティベーションの裏にある4つのAPI呼び出しとは?

すべては https://otproute.com/api/v1 配下にあり、or_live_ で始まるBearerキーで認証します。キーはDeveloperコンソールで発行され、1アカウントにつき最大10個のキーと5つのWebhookエンドポイントを登録でき、上限は毎分300リクエストです。

1. 見積もる。 GET /api/v1/prices?country=ar&service=<id> を呼び出し、ウォレット残高を使う前にリアルタイムの費用をコードに把握させます。アルゼンチンの国IDは ar です。
2. 注文する。 POST /api/v1/activations にJSONボディ {"service": "whatsapp", "country": "ar"} を送ります。サービスIDはテストに必要なものに置き換えてください。レスポンスには、アクティベーションIDと、テスト対象のアプリに入力する+54番号が含まれます。
3. 待つ。 適切な間隔で GET /api/v1/activations/{id} を読み取るか、activation.sms_received Webhookでコード到着の通知を受けます。
4. 必要なら早めに解放する。 POST /api/v1/activations/{id}/cancel は、不要になったアクティベーションを終了し、代金をウォレットに戻します。

IDをハードコードする前に確認したい場合は、GET /api/v1/services と GET /api/v1/countries で、プラットフォームが現在提供している内容を一覧できます。詳しいリファレンスはドキュメントにあります。

アルゼンチンのコードを受けるWebhook受信側を信頼できるものにするには?

すべての配信には、t=<unix>,v1=<hex> という形式の X-OTPRoute-Signature ヘッダーが含まれます。文字列 "<t>.<raw body>" を組み立て、そのエンドポイントのシークレットでHMAC-SHA256を計算し、結果を v1 と定数時間の関数で比較します。タイムスタンプが古いリクエストは破棄してください。古くても有効な署名は、まさにリプレイ攻撃の特徴だからです。

activation.sms_received に加えて activation.expired と activation.cancelled も購読しておけば、テストランナーがすでに終了した番号を待ち続けて止まることがありません。すべてのイベントをアクティベーションIDで管理し、同じイベントが2回配信されても何も変わらないようにハンドラーを書いてください。比較ロジックをより詳しく知りたい場合は、OTP Webhookの署名と検証の記事をご覧ください。

アルゼンチンの番号でどのアプリを認証できる?

アルゼンチンの現在のスナップショットには、2,000を超えるサービスが掲載されています。アルゼンチンのプロダクトチームやQAチームがよく使うものは次のとおりです。

• メッセージング:WhatsApp、Telegram、Signal、Discord
• アカウントと生産性:Google (Gmail & YouTube)、Microsoft & Outlook、LinkedIn、ChatGPT (OpenAI)
• ソーシャルと動画:Instagram、TikTok
• コマースとモビリティ:Amazon、Uber、Airbnb、Netflix

この一覧は一日の中で変動します。APIが静的な表ではなくリアルタイムの空き状況を返すのは、そのためです。スケジュールされたCIジョブを開始する前に、ar の国を念頭に GET /api/v1/services を照会し、対象サービスが一時的に欠けている場合は、わかりやすいメッセージとともにすぐに失敗させてください。

アルゼンチンの携帯番号が電話番号バリデーターで引っかかるのはなぜ?

アルゼンチンの番号計画は、地域内でもかなり特殊な部類に入ります。国内ではエリアコードの前にトランクの0を、モバイルでは加入者番号の前に15を付けて書くため、ブエノスアイレスの携帯は011 15の後に8桁が続く形で現れます。国際的なE.164形式では、この2つは消え、国番号の直後に9が挿入されます。+54 9 11の後に8桁の加入者番号が続きます。

この違いは、電話番号を保存するすべての人にとって重要です。保存する前にE.164へ正規化し、入力から0と15を取り除き、モバイル番号には9を付け足してください。長さしか確認しないバリデーターは、SMSを受信できない固定電話形式の+54 11の値を喜んで受け付けてしまいます。番号は自分で整形し直さず、APIが返したとおりに使ってください。

アルゼンチンの番号に送られるコードは、通常スペイン語で届き、数字の周りに「Tu código es」のようなフレーズが付くことがよくあります。テンプレートは変わるため、文言に一致させるのではなく、パターンで数字のコードを解析してください。このルートをテストするのは、ラテンアメリカに展開するとき、リオプラテンセ・スペイン語の文面(現地のvosの活用形は教科書的なスペイン語と異なります)を確認するとき、地域運用を行うとき、あるいは海外在住でも+54のSIMで登録するアルゼンチン人を対象にするときなどです。

コードを書かない人も+54番号を注文できる?

はい。サポート、グロース、代理店のスタッフは、ブラウザだけですべて行えます。

1. メールアドレスと6桁のコード、またはGoogleサインインでサインアップしてアカウントを作成します。
2. ウォレットに資金を追加します。
3. OTP Gatewayを開き、アルゼンチンを選んでから、テスト対象のサービスを選びます。
4. 表示された価格を確認して確定し、+54番号をアプリの認証画面にコピーします。
5. アクティベーションを見守ります。コードは受信されるとすぐにそこに表示されます。

ダッシュボードとAPIは同じウォレットと同じアクティベーションを使うため、開発者はチームメイトが注文した番号を、アクティベーションIDで引き継げます。

アルゼンチンのコードが届きません。次はどうする?

各アクティベーションは20分間有効です。何も届かない場合、またはその前にキャンセルした場合は、全額がウォレットに自動で戻るため、応答のないルートで失うのは金額ではなく時間です。配信速度はサービスとルートによって異なるため、失敗と判断する前に、有効時間をきちんと待ってください。

そのうえで、次の短いリストを確認してください。

• アプリ内からコードの再送を一度リクエストし、そのまま有効時間が過ぎるのを待ちます。
• 時間帯をずらして試すか、同じサービスを別のルートで注文します。
• そのサービスが仮想番号をそもそも受け付けるか確認します。拒否するサービスもあり、それが自動返金のある理由です。
• CIから短い間隔で繰り返し注文するのは避けます。バックオフと再試行回数の上限を設けてください。

アルゼンチンのルートに関するさらなるパターンは、OTP配信失敗を減らすの記事で紹介しています。すべてのテストは各サービスの利用規約の範囲内で行ってください。OTP Routeの利用規定(Acceptable Use Policy)も適用されます。

アルゼンチンの回線を保持できる?支払いは?

現時点で、アルゼンチンにはセルフサービスの長期番号はありません。チームに固定の+54回線が必要な場合は、[email protected] にメールで用途をお知らせください。実現できるかどうかは現地の規制によるため、確約はできません。更新が続く限り保持でき、受信SMSをWebhookに転送する専用仮想番号(Dedicated Virtual Numbers)は、米国とカナダ向けの製品で、月額$1.95からです。

課金は、月額料金もプラン選択もない、前払い式のUSDウォレット1つで行われます。カードまたはUSDT/USDCでチャージでき、チャージごとにPDFの請求書がメールで届きます。詳細は料金ページをご覧ください。実際の資金を使う前に、開発アカウントをサンドボックスに切り替えるよう依頼してください。シミュレートされた番号とコードが返るので、アルゼンチンのフロー全体をエンドツーエンドで予行演習できます。

よくある質問

OTP Route APIでのアルゼンチンの国IDは何ですか?

ar です。POST /api/v1/activations の country フィールドと、GET /api/v1/prices のクエリ文字列に指定します。

+54番号をアプリに入力するとき、9を付ける必要がありますか?

OTP Routeが返した番号をそのまま使ってください。自社のデータベースでは、アルゼンチンの携帯番号を、+54の後に9を含み、国内の0と15を除いたE.164形式で保存します。

アルゼンチンのSMS OTPを受信するにはいくらかかりますか?

$0.20/コードからで、サービスによって異なります。正確な金額は GET /api/v1/prices が返し、注文を確定する前に表示されます。

現地SIMなしで、自社アプリのアルゼンチン向け登録フローをテストできますか?

はい。自社アプリ、またはテストで使うサードパーティのサービス向けにアルゼンチンのアクティベーションを注文し、+54番号を入力して、ダッシュボードまたはWebhookでコードを読み取ってください。

来月のログインでも同じ+54番号を使えますか?

いいえ。ゲートウェイの番号は、20分以内の1回のコードに対応します。引き続きコードを受け取る必要があるアカウントには、米国またはカナダの専用番号(Dedicated Number)が適しています。

アルゼンチンの認証SMSは何語で届きますか?

通常はスペイン語ですが、送信元やアカウントの言語設定によって異なります。周囲の言葉に頼らず、数字を抽出してください。

Webhookの代わりにポーリングでも構いませんか?

はい。GET /api/v1/activations/{id} を控えめな間隔でポーリングし、アカウントあたり毎分300リクエストの上限を十分に下回るようにしてください。

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