アルバニア(+355)のOTPをテストパイプラインに取り込む

アルバニアの番号とそのコードを返すRESTコールは?

アルバニアOTP APIは、すべての市場で共通のSMS認証APIで、変わるのは国IDだけです。リクエストは https://otproute.com/api/v1 に対し、Developerコンソールで生成した or_live_ で始まるBearerキーを付けて送ります。アルバニアのIDは al で、典型的な実行は次のようになります。

1. GET /api/v1/services で必要なサービスID(たとえば telegram や google)を調べます。このリストは実行間でキャッシュしてください。
2. GET /api/v1/prices?country=al&service=<id> で最新価格を取得し、そのルートが今開いていることを確認します。
3. POST /api/v1/activations に {"service": "telegram", "country": "al"} を送ると、アクティベーションIDと+355番号が返ります。
4. テストが、テスト対象アプリの登録画面またはログイン画面にその番号を入力します。
5. コードはWebhook、または GET /api/v1/activations/{id} のポーリングで届きます。テストを中止する場合は POST /api/v1/activations/{id}/cancel を呼び出します。

1アカウントで最大10個のキーを持てるので、ステージング、CI、チームメンバーのノートPCにそれぞれ別のキーを割り当て、個別に無効化できます。毎分300リクエストの上限なら、複数のスイートを並列で動かす余裕があります。各フィールドの詳細はAPIリファレンスをご覧ください。

アルバニアのテストはポーリングとWebhookのどちらにすべきですか?

最も手早く実装できるのはポーリングです。ステータスが変わるまで、数秒おきにアクティベーションのエンドポイントを呼び出します。スイートを並列で動かすようになったら、Webhookのほうがすっきりします。最大5つのエンドポイントを登録し、activation.sms_received、activation.expired、activation.cancelled を購読してください。

すべての配信には署名が付きます。X-OTPRoute-Signature ヘッダーは t=<unix>,v1=<hex> の形式で、v1 はエンドポイントのシークレットで計算した "<t>.<raw body>" のHMAC-SHA256です。加工されていないリクエストのバイト列に対して再計算し、定数時間で比較し、古いタイムスタンプのものは破棄してください。再送された配信で二重に書き込まれないよう、イベントはアクティベーションIDで管理します。完全なハンドラーの例は、Webhookによる認証コード取得の記事で解説しています。

+355番号は、データベースに入れる前にどう正規化すべきですか?

アルバニアの国コードは+355で、国内トランクプレフィックスは0です。国内では携帯電話番号を先頭に0を付けて06X XXX XXXXと書くのが一般的ですが、国際形式では0を省いて+355 6X XXX XXXXとなります。E.164形式(+3556…、スペースなし)で保存し、現地向けの書式は表示時にのみ適用してください。

テスト用に+355番号を検証する際に追加しておきたいチェックは次のとおりです。

• +355を選択済みの状態で国内形式の番号が入力されたら、先頭の0を取り除きます。
• フォームが国コードを現地番号にそのまま連結したときに現れる、+355 0 6Xのような二重のプレフィックスは拒否します。
• 保存する値にスペース、ハイフン、かっこを含めません。

コードの前後の文面は、送信元のサービスとアカウントの言語設定によって決まり、アルバニア語と英語の両方がよく使われます。固定の文面ではなく、数字の部分を対象にパーサーを書いてください。このマーケットをテストするのは、アルバニアで展開するとき、地域内外のアルバニア語話者向けにアプリをローカライズするとき、あるいは現地の運用アカウントが引き続き認証できるか確認するときです。

アルバニアのルートでは何を認証できますか?

アルバニアのルートには、現在1,500を超えるサービスが載っています。最新のスナップショットで人気のあるものには、WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、Viber、Signal、Microsoft & Outlook、ChatGPT (OpenAI)、Uber、LinkedIn、Discordがあります。

在庫は一日の中で変動するため、利用可否は固定のリストではなくAPIから取得します。テストごとに al の価格照会を前提条件にし、ルートがたまたま閉じているときは、失敗ではなくスキップとして記録してください。そうすれば、OTPルーティングのノイズが本来の回帰テスト結果に混ざりません。

技術者でないチームメンバーも+355番号を注文できますか?

はい。ダッシュボードなら、コードを書かずに同じ流れを実行できます。

1. メールアドレスと6桁のメールコード、またはGoogleサインインで登録し、TOTP二要素認証を有効にします。
2. カードまたはUSDT/USDCでウォレットに資金を追加します。
3. アルバニアとサービスを選び、表示された価格を確認して注文を確定します。
4. アルバニアの認証番号をアプリに入力します。SMSが届くと、アクティベーションページにコードが表示されます。

クライアントのプロフィールを管理する代理店や、地域のビジネスアカウントを設定する運用担当者は、この方法を使うことが多いです。ここでの注文もAPIでの注文も、ウォレットと返金ルールは共通です。

アルバニアのSMSが届かなかったらどうなりますか?

アクティベーションは20分間有効です。コードが届いたときだけ料金が発生し、何も届かないまま時間切れになった場合、または早めにキャンセルした場合は、全額が自動的にウォレットへ戻り、Webhookで activation.expired または activation.cancelled が発火します。

コードが届かないときは、次の点を確認してください。

• 反応する前に有効時間を待ちます。送信が遅いサービスもあります。
• そのサービスが仮想番号を受け付けるか確認します。ポリシーとして拒否するところもあります。
• 後でもう一度試すか、テスト上可能なら別のサービスルートを試します。
• 短い間隔での再注文は避けます。試行の間隔を空けて、スクリプトがルートに負荷をかけないようにします。

バルカン半島のルートを含め、さらなる再試行パターンはOTP配信失敗を減らすの記事にまとめています。これらの番号は自社の製品とアカウントにのみ使用し、各サービスの規約に従ってください。また、OTP Routeの利用規定(Acceptable Use Policy)が適用されます。

アルバニアの長期回線はありますか?課金の仕組みは?

アルバニアにはセルフサービスの長期番号はありません。専用仮想番号は米国とカナダでのみ即時に販売しており、月額$1.95から、受信SMS、Webhook転送、送信SMS、ブラウザ通話が付きます。アルバニアの長期回線が必要な場合は [email protected] までメールしてください。手配できるかどうかは現地の規制によるため、保証はできません。

課金は、月額料金もプラン選択もない、前払い式のUSDウォレット1つで行います。カードまたはUSDT/USDCでチャージでき、チャージごとにPDFの請求書がメールで届きます。最新の料金は料金ページで確認できます。連携開発では、開発アカウントのサンドボックス切り替えを依頼してください。シミュレートされた番号とコードが返るので、ウォレットの資金を使わずにパイプラインを検証できます。

よくある質問

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

はい。国に al を指定してOTP Gatewayの番号を注文し、登録画面に入力して、ダッシュボードまたはWebhookでコードを読み取ります。SIMも現地キャリアとの契約も必要ありません。

アルバニアの認証コードはいくらですか?

コードは$0.20/コードからで、特定のサービスの正確な価格は、注文前に GET /api/v1/prices で取得できます。20分の有効時間内に何も届かなければ、料金はウォレットに戻ります。

アルバニアの番号は先頭の0を付けて保存すべきですか?

いいえ。+355に、トランクの0を除いた国内番号を続けたE.164形式で保存し、0は現地向けの表示時にのみ付け直してください。

同じ+355番号を、後のログインに再利用できますか?

OTP Gatewayの番号が扱えるのは1回分の認証コードです。繰り返しログインが必要なアカウントには、米国またはカナダの専用番号を使うか、アルバニアについてサポートにご相談ください。

OTP Routeにはアルバニアの連携テスト用サンドボックスがありますか?

開発アカウントは、リクエストによりサンドボックスモードに切り替えられます。シミュレートされた番号とコードが返るので、CIの実行でウォレットの資金を使わずにフロー全体を検証できます。

アルバニアの番号がアプリに拒否されたのはなぜですか?

仮想番号を拒否するサービスもあります。アクティベーションをキャンセルするか期限切れにすれば自動で返金されるので、時間を変えるか、別のルートでもう一度試してください。

アルバニアではどのAPI IDを使いますか?

価格照会とアクティベーションのリクエストで、country の値に al を指定し、サービスIDは GET /api/v1/services から取得します。

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