開発者のためのヨルダン(+962)認証コード受信ルート

+962番号のリクエストの流れは?

SMS認証APIは https://otproute.com/api/v1 にあるシンプルなRESTで、Developerコンソールで生成した or_live_ で始まるBearerキーを使います。ヨルダンでの一般的な連携の順序は次のとおりです。

1. 探索:GET /api/v1/services と GET /api/v1/countries が識別子を返します。ヨルダンは jo、Telegramなどのサービスは telegram です。
2. 価格の確認:GET /api/v1/prices?country=jo&service=telegram が、その組み合わせの現在の料金と、注文できるかどうかを返します。
3. 注文:{"service": "telegram", "country": "jo"} を本文にして POST /api/v1/activations を送ると、番号が確保され、アクティベーションIDが返されます。
4. 取得:GET /api/v1/activations/{id} を数秒おきにポーリングするか、Webhookに結果をプッシュさせます。
5. 後片付け:POST /api/v1/activations/{id}/cancel で、不要になったアクティベーションを解放し、返金します。

GET /api/v1/balance は、テスト実行の冒頭で確認しておくと便利です。ウォレットの残高が少ないときに、ジョブがわかりやすいメッセージで早めに失敗します。完全なリファレンスはドキュメントにあります。

Webhookが本当にOTP Routeから届いたものだと確認するには?

各イベント(たとえば activation.sms_received や activation.expired)は、t=<unix>,v1=<hex> という形式の X-OTPRoute-Signature ヘッダー付きで届きます。サーバー側でそのエンドポイントのシークレットを使い、"<t>.<raw body>" のHMAC-SHA256を計算し、結果を v1 と比較します。値が一致しない場合や、t が過去すぎる場合は、リクエストを拒否してください。これでリプレイを防げます。

再試行により同じイベントが2回届くことがあるため、処理はアクティベーションIDをキーにし、2通目は何もしないものとして扱います。公開Webhook URLを用意しにくいローカル開発では、ポーリングが引き続き堅実な代替手段です。キューイングと再試行については、Webhookによる認証コードの取得の記事で解説しています。

ヨルダンのルートで認証できるアプリは?

ヨルダンでは1,700を超えるサービスが一覧にあります。人気のものには、WhatsApp、Telegram、Facebook、Instagram、Snapchat、TikTok、X (Twitter)、Discord、Claude、Microsoft & Outlook、Amazon、Viber、imo、Signal、LinkedInがあります。

この一覧はスナップショットであり、保証ではありません。キャリアの容量は一日の中で変動するため、APIがリアルタイムの利用可否を返します。コードは、注文の前にそれを読み取ってください。

ヨルダンの番号の書式:トランクのゼロ、E.164、アラビア語のテキスト

ヨルダンの国番号は+962、トランクプレフィックスは0です。現地では携帯番号は07から始まる形で書きますが、国際形式ではゼロが消え、+962 に7で始まる9桁が続きます。E.164形式で保存し、ユーザーが現地の番号を貼り付けたときは、国番号を付ける前に先頭の0を取り除いてください。07… と +9627… を文字列として比較するのは、重複アカウントのバグの典型的な原因です。

公用語はアラビア語で、多くの人が端末やアプリをアラビア語に設定しています。アプリとアカウントの言語設定によって、コードはアラビア語または英語のテキストで届くことがあります。アラビア語のメッセージはUnicodeで送られ、数字が右から左のテキストの中に入ることもあるため、パターンでコードを抽出し、両方の言語でテストしてください。

チームがヨルダンを扱うのは、アラビア語話者向けにプロダクトをローカライズするとき、アンマンから広域の地域のサポートを運営するとき、あるいはサウジアラビアやアラブ首長国連邦など近隣市場と並べてフローを確認するときです。

ダッシュボードからヨルダンのコードを注文する

運用担当者は、コードを書かなくても同じことができます。メールと6桁のコード、またはGoogleサインインでアカウントを作成し、資金を追加し、OTP Gatewayでヨルダンとサービスを選び、表示された価格を確認して注文します。+962番号がすぐに表示され、SMSが届くとその隣にコードが表示されます。

アクティベーションは20分間オープンです。課金されるのはコードが届いたときだけで、ウィンドウが空のまま閉じた場合やキャンセルした場合は、金額が自動的にウォレットに返金されます。

コードが届かないときのデバッグの順序

最も手軽な原因から順に、外側へ向かって調べます。

• ウィンドウはまだ開いている? 配信はサービスとルートに左右されます。失敗と判断する前に、20分をフルに使ってください。
• そのサービスは仮想番号を受け付けている? 受け付けないサービスもあり、未使用のアクティベーションが返金されるのはそのためです。
• 別のルートを試す。 時間をおいて再注文するか、プロダクトで可能なら、同じ機能に別のサービスルートを使います。
• 再試行を抑える。 数秒おきに再注文するループは試行を消費するだけなので、間隔をあけてください。

テストするのはご自身が所有・運用するアカウントだけにし、各サービスの規則に従ってください。OTP Routeの利用規定(Acceptable Use Policy)はすべての利用に適用されます。

長期回線、ウォレット、サンドボックス

OTP Routeには、ヨルダンのセルフサービスの長期番号はありません。月額$1.95からのDedicated Numbersは、米国とカナダでのみ即時に提供されます。+962の継続的な回線が必要な場合は、[email protected] にご連絡ください。手配できるかどうかは現地の規制次第です。

ウォレットはUSDの前払いで、月額料金もなく、選ぶプランもありません。カードまたはUSDT/USDCでチャージでき、チャージのたびにPDFの請求書がメールで届きます。インテグレーション中は、開発アカウントにサンドボックスモードを依頼すれば、資金を使わずに模擬の番号とコードを受け取れます。最新のレートは料金をご覧ください。

よくある質問

ヨルダンのAPI用の国コードは?

OTP Route APIの country の値として jo を使います。たとえば GET /api/v1/prices?country=jo&service=whatsapp のように指定します。

ヨルダンの携帯番号の0は取り除くべき?

はい、国際形式では取り除きます。現地の07の番号は、+962 に7で始まる9桁が続く形になります。

ヨルダンの認証コードはアラビア語で届く?

届くことがあります。言語は通常アプリとアカウント設定に従うため、パターンで数字を解析し、アラビア語と英語の両方のメッセージでテストしてください。

コードのために+962番号はどのくらい確保される?

各アクティベーションは20分間です。その間にSMSが届かなければ、料金はウォレットに返金されます。

自分で保持できる専用のヨルダン番号は取得できる?

セルフサービスではできません。Dedicated Numbersは米国とカナダの商品で、ヨルダンについては [email protected] にメールで問い合わせできます。

自動テストでヨルダンのSMS OTPを受信する方法はある?

はい。POST /api/v1/activations で注文し、アクティベーションをポーリングするか、署名付きWebhookを処理します。サンドボックスアカウントなら、模擬のコードで予行演習ができます。

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