対応ルートが少ない西サハラの電話認証への対処法

電話番号バリデーターが+212の番号を別の地域と判定し続けるのはなぜですか?

西サハラはモロッコと国番号+212を共有しています。広く使われている電話番号ライブラリは、これを同じ国番号を使う別の地域として扱うため、番号だけで検索するとどちらも返りうる状況です。国のドロップダウンを持つチームは、ユーザーが西サハラを選んで有効な+212番号を入力したのに、バックエンドが別の地域に再分類したり、地域が一致しないとして拒否したりして、初めてこの問題に気づくことがよくあります。

修正を出荷する前に、実際の西サハラの認証番号で再現してみる価値のある、まさにそうしたエッジケースです。すでに北アフリカを対象にしている物流会社、NGO、地域の運用チームもこの問題に直面しており、実際のルートで手早くテストするほうが、推測するより安上がりです。

西サハラの番号にコードを送れるサービスは?

このルートのライブスナップショットには20を超えるサービスが掲載されていますが、近隣の市場と比べるとカタログははるかに短いです。現在掲載されているのは、TikTok、Amazon、LinkedIn、AliExpress、Flipkart、Mercado Libre、Mercado Pago、Coinbase、Bumble、Swiggyです。

リストが短く、供給も一日の中で入れ替わるため、テストを予定する前に必ず GET /api/v1/countries かダッシュボードで利用可否を確認してください。必要なサービスが見当たらない場合は、モロッコ、モーリタニア、アルジェリアといった近隣のルートのほうがはるかに多くのサービスを扱っていて、北アフリカの番号が必要なだけのテストなら、それでも用が足りることが少なくありません。

西サハラのOTP APIリクエストはどう動きますか?

国IDは eh です。手順は他のどの市場とも同じです。

• GET /api/v1/services でサービスIDを調べます。
• GET /api/v1/prices?country=eh&service=<id> で価格を確認します。
• サービスと eh を指定したボディで、POST /api/v1/activations により注文を作成します。
• GET /api/v1/activations/{id} で結果を読み取るか、Webhookで activation.sms_received を受信します。
• テストを取りやめる場合は POST /api/v1/activations/{id}/cancel でキャンセルします。

すべてのWebhookで X-OTPRoute-Signature ヘッダー(エンドポイントのシークレットによる、タイムスタンプと生のボディに対するHMAC-SHA256)を検証し、古いタイムスタンプは拒否してください。キーのプレフィックスは or_live_ で、最大10個保持でき、1分あたり300リクエストまで送信できます。完全なリファレンスは開発者ハブからたどれます。

コードを書かずに注文できますか?

はい。メールコードまたはGoogleでサインアップすれば、サポートやプロダクトの担当者がOTP Gatewayを開き、西サハラと利用可能なサービスのひとつを選び、価格を確認して、+212番号をテスト対象のアプリにコピーできます。SMSが配信されると、注文の横にコードが表示されます。

この地域の+212番号はどう保存すべきですか?

番号体系はモロッコと同じ+212で、国内ではトランクプレフィックス 0 を使います。国内で06または07から始まる携帯番号は、国際形式では+212 6…または+212 7…になります。E.164形式でゼロなしで保存し、プロダクトで地域を把握する必要がある場合は、番号から推測せず、ユーザーが明示的に選択した値を専用のフィールドに保存してください。

日常生活の主な言語はアラビア語で、スペイン語やフランス語も聞かれますが、ほとんどのグローバルアプリはアカウントや端末の設定からSMSの言語を選びます。自社のテンプレートがユーザーに表示される場合は、アラビア語とラテン文字のロケールの両方でテストしてください。

西サハラの番号に何も届かなかったら?

ルートが細いと、ときどき受信できないことがあるので、それを許容するテストを組みましょう。

1. 20分の待機時間を最後まで待ちます。遅れて届いたSMSも有効です。
2. 課金されるのはコードが届いたときだけで、期限切れまたはキャンセルされたアクティベーションは自動的に返金されます。
3. 時間を置いて再試行するか、テストケースが許せば近隣のルートに切り替えます。
4. 対象のサービスが仮想番号を受け付けているかを確認します。方針として断るサービスもあります。
5. 立て続けに注文せず、再試行の間隔を空けます。

市場のフォールバックリストの作り方は、OTPの国別ルーティングのガイドで解説しています。

長期回線は可能ですか?課金はどうなりますか?

セルフサービスで使える西サハラの長期番号はありません。専用番号は米国とカナダ向けの商品で、月額$1.95からです。ここで長期の回線が本当に必要なチームは [email protected] に問い合わせできますが、手配できる保証はありません。

OTP Gatewayの利用料金は、サブスクリプションもプランもないプリペイドUSDウォレットから支払います。カードまたはUSDT/USDCでチャージでき、チャージのたびにPDF請求書がメールで届きます。開発用アカウントは、リクエストに応じてサンドボックスに切り替えられ、シミュレーションによるエンドツーエンドのテストができます。詳細は料金ページをご覧ください。

よくある質問

現地のSIMなしで、西サハラのサインアップをテストできますか?

はい。必要なサービスがこのルートのライブ一覧にあれば可能です。OTP Gatewayで+212番号を注文し、ダッシュボードまたはAPIでコードを読み取ります。

OTP Routeは西サハラにどの国IDを使いますか?

eh を使います。+212を共有していても、モロッコの ma とは異なります。

このルートで利用できるサービスがこれほど少ないのはなぜですか?

ここでは通信事業者パートナーからの供給が限られており、一日の中で変動するため、APIがその時点で注文可能なものを報告します。

西サハラの認証番号はいくらですか?

料金は1コード$0.20からで、正確な金額はサービスによって異なり、確定する前に表示されます。

失敗したアクティベーションにも課金されますか?

いいえ。20分経ってもSMSが届かなかった、またはキャンセルしたアクティベーションは、全額がウォレットに返金されます。

どのような利用ルールが適用されますか?

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

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