APIでイエメン(+967)の認証コードを収集する

+967のコードを取得する最短のAPI経路は?

クライアントの接続先を https://otproute.com/api/v1 にし、開発者コンソールのBearerキーを使います。キーのプレフィックスは or_live_ です。イエメンの国IDは ye です。

1. GET /api/v1/prices?country=ye&service=<id> で価格を取得します。レスポンスには、コードの料金とルートが開いているかどうかが含まれます。
2. 注文を作成します:POST /api/v1/activations に {"service": "whatsapp", "country": "ye"} を渡します。アクティベーションIDと+967番号が返ります。
3. 番号を、自社アプリの認証ステップに入力するか、注入します。
4. GET /api/v1/activations/{id} またはWebhookイベントからコードを取得します。
5. 未完了の注文は POST /api/v1/activations/{id}/cancel で解放します。

GET /api/v1/services と GET /api/v1/countries はめったに変わらないため、一日キャッシュしてかまいません。バッチの前に GET /api/v1/balance を呼べば、残高が少なくなったときにジョブを早めに止められます。1分あたり300リクエストのレート制限はアカウント単位で適用され、キーは最大10個発行できます。このイエメンOTP APIの流れの実例は、連携ガイドをご覧ください。

イエメンのアクティベーションのWebhook配信はどう検証しますか?

開発者コンソールでHTTPSエンドポイントを登録し(アカウントあたり5つまで)、activation.sms_received を購読します。あわせて activation.expired と activation.cancelled も購読しておくと、ジョブがいつ待機を止めるべきか分かります。

署名の検証手順は決まっています。X-OTPRoute-Signature を t と v1 に分け、エンドポイントのシークレットを使って文字列 <t>.<raw body> のHMAC-SHA256を計算し、結果を v1 と定数時間の関数で比較します。タイムスタンプが許容範囲より古い場合はリクエストを拒否します。配信は再試行されることがあるため、ハンドラーは冪等にしてください。アクティベーションIDを保存し、重複は無視します。クロックのずれなどのエッジケースは、HMACによるOTP Webhookの保護で扱っています。

アラビア語のメッセージを、パーサーはどう扱うべきですか?

アラビア語はイエメンの公用語のため、多くのサービスは前後の文章をアラビア語で送ります。自社のメッセージをテストする人には実務上の影響があります。アラビア文字はUCS-2エンコードが必要で、1つのSMSセグメントは70文字に制限されます。また、右から左へ書くテキストでは、通知内のコードの位置がずれることがあります。テンプレートによって、数字が文章の前にあるものも、後にあるものもあります。

抽出処理は、前後にどんな単語があっても数字の連続を見つけるように書いてください。送信元がアラビア・インド数字(٠から٩)を使う場合に備えて、ASCIIの数字に正規化しておくのも賢明です。こうしたチェックは、アラビア語話者向けにアプリをローカライズするとき、湾岸諸国で暮らすイエメン人の顧客をサポートするとき、あるいは地域のサポートアカウントが今も認証できるかを確認するときに行われます。OTP Routeはメッセージを受信したままの形で返すため、テストで解析するものは、ユーザーが実際に受け取るものと同じです。

イエメンの電話番号はどのような形式ですか?

国番号は+967です。携帯番号はその後ろに9桁が続き、7で始まるため、+967 7XX XXX XXXという形になります。ユーザーが国内表記の0を先頭に付けて入力した場合は、保存前に取り除き、区切り文字なしのE.164文字列で保持してください。国内表記の整形はUIだけの役割です。

+967のテスト用番号で有用な検証ケースは次のとおりです。

• ユーザーが国リストから+967を選んだ上で、国番号を含むフルの番号をもう一度入力する。
• 連絡先カードからコピーしたアラビア・インド数字の番号が貼り付けられる。
• 数字のグループの間にスペースやダッシュが入る。

これらはいずれも同じ保存値に落ち着く必要があり、それが検索と重複排除の信頼性を保ちます。

現在、+967番号に対応しているサービスは?

イエメンでは、OTP Gatewayで1,700を超えるサービスが利用できます。ライブのスナップショットでよく使われているのは、WhatsApp、Telegram、imo、Facebook、Instagram、TikTok、Snapchat、Google(Gmail & YouTube)、X(Twitter)、Microsoft & Outlook、Signal、Discord、Amazonなどです。

利用可否は常に動いているため、スイートは最初にAPIへ問い合わせるように作ってください。エンジニア以外の人も、ダッシュボードから同じことができます。メールコードまたはGoogleサインインでアカウントを開設し、チャージして、イエメンとサービスを選び、イエメンの認証番号をアプリにコピーして、アクティベーションページでコードを待ちます。

イエメンのコードが届かないことがあるのはなぜで、どう対処しますか?

各注文の有効期間は20分です。SMSが届かない場合、またはその前にキャンセルした場合は、全額が自動的にウォレットへ戻ります。課金されるのは、届いたコードの分だけです。

よくある原因と対処は次のとおりです。

• その時点でサービスの送信が遅い:諦める前に待機時間を最後まで使います。
• サービスが仮想番号を拒否している:そのポリシーを確認します。失敗した試行は返金で対処されます。
• ルートが混雑している:時間を置くか、別のサービスルートで試します。
• スクリプトが受信できなかった瞬間に再注文する:ルートに負荷をかけないよう、バックオフを入れます。

これらの番号は、自社のプロダクトと正当なアカウントにのみ使用し、各サービスの利用規約に従い、OTP Routeの利用規定の範囲内でご利用ください。

イエメンの番号を長期保有できますか?課金はどうなりますか?

セルフサービスではできません。専用バーチャル番号は米国とカナダでのみ提供され、月額$1.95からですぐに購入できます。継続して使える+967回線が必要なチームは [email protected] にメールできますが、提供できるかどうかは現地の規制次第で、確実ではありません。

OTP Routeのウォレットは、サブスクリプションもプランもないUSDのプリペイド方式です。カードまたはUSDT/USDCでチャージでき、そのたびにPDF請求書がメールで届きます。現在のレートは料金ページで確認でき、連携作業のためにシミュレートされた番号とコードが必要な場合は、開発用アカウントのサンドボックスを依頼してください。

よくある質問

現地のSIMなしで、イエメンの番号を使ってアラビア語のサインアップフローをテストできますか?

はい。国 ye でOTP Gatewayの番号を注文し、自社アプリに入力して、アラビア語または英語のメッセージをダッシュボードまたはWebhookで読み取ります。

+967認証コードの料金はいくらですか?

1コード$0.20からで、サービスによって異なります。ライブの金額は GET /api/v1/prices で返されます。届かなかったコードは、20分の待機時間の終了時に返金されます。

SMSが右から左に書かれている場合、コードをどう抽出しますか?

文章のパターンではなく、数字の並びを検索し、先にアラビア・インド数字をASCIIに変換してください。そうすれば、コードがテキストのどちら側にあっても機能します。

+967の番号はそのまま保有できますか?

いいえ。OTP Gatewayの番号は1回の認証専用です。長期番号は米国とカナダの商品で、イエメンについてはサポートにメールで問い合わせてください。

ウォレット残高を使わずに連携できますか?

はい。開発用アカウントにサンドボックスを依頼してください。シミュレートされた番号とコードが返されるので、ポーリング、Webhook、エラー処理のテストには十分です。

APIでイエメンが使う国IDは何ですか?

ye です。価格照会と、POST /api/v1/activations のJSONボディに渡します。

サービスがイエメンの番号を拒否したのはなぜですか?

仮想番号を受け付けないサービスもあります。キャンセルするか、アクティベーションを期限切れにすれば、お金は自動的にウォレットへ戻ります。

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