エチオピア(+251)のSMSコードをテストパイプラインに取り込む

エチオピアの認証コードを取得するAPI呼び出しは?

エチオピア向けのOTPルーティングは、https://otproute.com/api/v1 に対する5つのシンプルなHTTP呼び出しに集約されます。各呼び出しは、Developerコンソールで発行した or_live_ で始まる Bearer キーで認証します。1アカウントに最大10個のキーを持てるため、CI、ステージング、ローカルのノートPCで、それぞれ別の認証情報を使えます。

1. GET /api/v1/countries はすべてのルートを一覧し、エチオピアはID et で表示されます。
2. GET /api/v1/services はサービスIDを返し、GET /api/v1/prices?country=et&service=<id> は、テストしたい組み合わせの現在の価格と在庫を報告します。
3. POST /api/v1/activations に {"service": "telegram", "country": "et"} を送ると、+251番号が確保され、アクティベーションIDが返されます。
4. その番号をテスト対象プロダクトの電話番号フィールドに入力し、SMSを送信させます。
5. Webhookイベント、または GET /api/v1/activations/{id} のポーリングでコードを読み取り、実行を途中で終えるときは POST /api/v1/activations/{id}/cancel で整理します。

在庫は一日の中で動くため、何かを固定で書き込まず、実行時に価格エンドポイントを呼んでください。スイートの開始前に GET /api/v1/balance を実行すれば、ウォレットの残高が少ないときにジョブを早めに止められます。このSMS認証APIのリクエストとレスポンスの形は、開発者向けドキュメントにあります。

+251のアクティベーション用に、署名付きWebhookをどう組み込む?

単発のテストならポーリングで十分ですが、並列ジョブでは、イベントが自分に届くほうが扱いやすくなります。1アカウントあたり最大5つのWebhookエンドポイントを登録し、activation.sms_received、activation.expired、activation.cancelled を購読してください。

すべてのリクエストには X-OTPRoute-Signature: t=<unix>,v1=<hex> が付きます。エンドポイントのシークレットで <t>.<raw body> のHMAC-SHA256を再計算し、結果を v1 と定数時間で比較し、タイムスタンプが古い場合はその呼び出しを拒否します。JSONパーサーに渡す前に、生のバイト列で検証してください。

イベントは複数回配信される可能性があると想定し、ハンドラーはアクティベーションIDをキーにして重複を捨てます。そうすれば、再送されたイベントがOTPフィールドに2回入力されることはありません。ポーリングを続ける場合は、数秒の間隔なら、毎分300リクエストの上限に十分収まります。リファレンスのハンドラーは、HMACによるOTP Webhookの保護の解説に含まれています。

今すぐエチオピアのSMS OTPコードを受信できるサービスは?

エチオピアのルートは現在、1,700を超えるサービスを掲載しています。リアルタイムのスナップショットで人気の項目には、WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、ChatGPT (OpenAI)、Microsoft & Outlook、LinkedIn、Uber、Signal、Viber、imo、Netflixがあります。

この一覧はスナップショットとして扱ってください。個別のサービスの利用可否は数時間で変わることがあるため、APIは静的な表ではなくリアルタイムで報告します。各実行の開始時に国と価格のエンドポイントを問い合わせ、あまり一般的でないものが必要な場合は、ダッシュボードでカタログ全体を検索してください。

QAチームが知っておくべき+251の番号形式とSMSの言語は?

E.164形式のエチオピアの番号は、+251 に9桁が続きます。国内では、この9桁の前に先頭の 0 を付けてダイヤルするため、ユーザーはフォームに09…と入力することがよくあります。そのトランクの0を取り除き、+251を付けて、正規のE.164文字列として保存し、現地式の表記は画面表示でのみ使ってください。電話番号の入力検証は、登録まわりのバグが潜みやすい場所なので、両方の入力に加え、スペースやハイフンも網羅してください。

アムハラ語は連邦の業務言語で、エチオピア文字(ゲエズ文字)で書かれます。一方、オロモ語、ティグリニャ語、ソマリ語は各地域で広く使われています。国際的なサービスの多くはコードを英語で送りますが、ローカライズされたテンプレートはアムハラ語で届くこともあります。周囲の単語ではなくパターンで数字を抽出し、ログがUTF-8を正しく保存していることを確認してください。

このルートをテストするのは、たいてい、エチオピアのユーザー向けにアプリを立ち上げるとき、アムハラ語のローカライズを確認するとき、あるいは母国の番号で登録するディアスポラの顧客に対応するときです。プロダクトが日付を表示する場合は、エチオピア独自の暦も、追加する価値のある別のローカライズのケースです。他のチームがこうしたスイートをどう構成しているかは、QAテストのページをご覧ください。

開発者でなくても、ダッシュボードからエチオピアの認証用番号を取得できる?

はい。プロダクトマネージャーやサポート担当者は、コードを書かずに同じフローを実行できます。

1. メールアドレスと6桁のコード、またはGoogleサインインでアカウントを作成し、TOTPの二要素認証を有効にします。
2. ウォレットに資金を追加します。
3. エチオピアを選び、サービスを選択して、確定する前に表示された価格を確認します。
4. +251番号を、認証したいアプリに貼り付けます。
5. アクティベーションを開いたままにします。コードを受信すると、そこに表示されます。

多くのチームは、エンジニアがAPI経由で同一のルートを動かす一方で、単発の動作確認にこの方法を使っています。

+251のコードが届かないときは?

各アクティベーションは20分間有効です。課金されるのはコードが届いた場合のみです。SMSが届かないまま有効時間が終了した場合、またはキャンセルした場合は、全額が自動的にウォレットへ戻ります。

何も届かないときは、次を試してください。

• 失敗と判断する前に、有効時間を最後まで待ちます。タイミングはサービスとルートによって異なります。
• 後で再試行するか、テストケースが許す場合は別のサービスルートに切り替えます。
• そのサービスが仮想番号を受け付けるかを確認します。拒否するサービスもあり、返金はまさにこうした状況のためにあります。
• 短い間隔で再注文しないでください。再試行の間隔を空け、アクティベーションIDを記録して、パターンが見えるようにします。

ほかの確認項目は、OTP配信失敗を減らすの記事に挙げています。

エチオピアの長期回線はある? 課金はどうなる?

OTP Routeには、エチオピアのセルフサービスの長期番号はありません。更新しながら維持する回線である専用番号は、米国・カナダ向けの製品で、月額$1.95からです。継続的な+251回線が必要な場合は [email protected] にメールで問い合わせてください。提供の可否は現地の規制によるため、保証はされません。

エチオピアのアクティベーションは、月額料金もプランの選択もない、前払いのUSDウォレット1つから引き落とされます。カードまたはUSDT/USDCステーブルコインで入金でき、入金のたびにPDFの請求書が受信トレイに届きます。新しい連携に実際の資金を使う前に、開発用アカウントのサンドボックスモードを依頼してください。シミュレートされた番号とコードが返るので、フロー全体をエンドツーエンドで試せます。

OTP Routeのエチオピアのテスト用番号は、御社が正当に所有するプロダクトとアカウントの検証用です。各サービスの利用規約は引き続き適用され、当社のAcceptable Use Policyも同様です。

よくある質問

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

はい。OTP Gatewayでサービス用の+251番号を注文し、アプリに入力して、ダッシュボードまたはAPIでコードを読み取ります。課金されるのはコードが届いた場合のみです。

OTP Route APIでのエチオピアの国IDは何ですか?

et です。エチオピアのアクティベーションを作成するときと、価格を照会するときの country フィールドに et を送ります。

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

コードは1コード$0.20からです。サービスごとの正確な金額は GET /api/v1/prices が返し、注文前にダッシュボードにも表示されます。

エチオピアの電話番号は、先頭の0を付けて保存すべきですか?

いいえ。E.164形式、つまり+251に9桁を続けた形で保持し、ユーザーが国内の0を入力したら取り除いてください。ローカルの書式は画面上でのみ適用します。

エチオピアの認証テキストはアムハラ語で届きますか?

通常は英語ですが、サービスによってはエチオピア文字のアムハラ語テンプレートを使うことがあります。どちらでも動くよう、文言ではなく数字を解析してください。

後のログインのために、エチオピアの番号を保持できますか?

セルフサービスではできません。ワンタイム番号は1回のコード用だからです。再度サインインが必要なアカウントには、米国またはカナダの専用番号が向いています。エチオピアについては、サポートへメールで問い合わせることもできます。

ウォレットの資金を使わずにエチオピアOTP APIを試す方法はありますか?

はい。開発用アカウントのサンドボックスモードを依頼すると、シミュレートされた番号とコードが返るので、連携をエンドツーエンドでテストできます。

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