APIでアイスランド（+354）の認証コードを受信する

アイスランドの認証番号を取得するAPIコールは何ですか？

まず、OTP RouteのDeveloperコンソールでBearerキーを取得します。ライブキーは or_live_ で始まり、1つのアカウントで最大10個まで保持できます。すべてのコールは https://otproute.com/api/v1 に対して行い、上限は1分あたり300リクエストなので、並列のテストマトリクスにも十分な余裕があります。

• GET /api/v1/countries は国の一覧を返します。アイスランドは is として表示されます。
• GET /api/v1/services はサービスIDを返します。たとえば telegram です。
• GET /api/v1/prices?country=is&service=telegram で、その組み合わせの現在の価格が分かります。
• POST /api/v1/activations に {"service": "telegram", "country": "is"} を送ると、番号が確保され、アクティベーションIDが返ります。
• GET /api/v1/activations/{id} はステータスを返し、配信されたあとはコードも返します。
• POST /api/v1/activations/{id}/cancel で、未使用の+354の注文を取り消して返金します。
• GET /api/v1/balance を使えば、資金が少なくなったときにジョブを早めに止められます。

リクエストとレスポンスの例を含む解説は、連携ガイドにあります。

ポーリングではなくWebhookで+354のコードを受信するには？

1つのアカウントで、最大5つのhttpsエンドポイントを登録できます。そのうち1つをアイスランドのテストランナーに向け、activation.sms_received、activation.expired、activation.cancelled の各イベントを待ち受けてください。イベントはアクティベーションIDをキーにしているため、ハンドラーはそれぞれのイベントを、注文を出したテストに対応づけられます。

すべてのリクエストには X-OTPRoute-Signature: t=<unix>,v1=<hex> が含まれます。エンドポイントのシークレットで "<t>.<raw body>" のHMAC-SHA256を再計算し、定数時間で比較し、短い許容範囲を超えるタイムスタンプは拒否します。再送された配信でテストが2回合格扱いにならないよう、ハンドラーは冪等にしてください。エッジケースは、OTP Webhookの保護で一通り解説しています。

アイスランドのルートで使えるサービスは何ですか？

アイスランドでは現在、1,400を超えるサービスが利用できます。最新のスナップショットで目立つのは、WhatsApp、Telegram、Google（Gmail & YouTube）、Facebook、Instagram、Snapchat、Discord、ChatGPT（OpenAI）、Claude、Microsoft & Outlook、Amazon、Uber、Airbnb、Netflix、Signalです。

可用性は一日の中で変わります。昨日の結果に頼らず、注文の直前にライブの一覧を問い合わせてください。

アイスランドの電話番号には、どんな特徴がありますか？

アイスランドには、トランクプレフィックスも市外局番もありません。加入者番号は7桁で、携帯番号は通常6、7、8のいずれかで始まります。そのため正規化は簡単で、E.164形式は +354 に直接その7桁を続けたものとなり、現地の人がフォームに書く番号は、国コードを除いた同じ数字です。

この短さは、より長い国内形式を前提にしたバリデーターを混乱させます。電話番号の入力欄が8桁または9桁以上を最小として要求していると、アイスランドの顧客は登録自体ができなくなるため、入力テストに+354のケースを追加してください。保存するのはE.164の文字列にして、現地の7桁のグループ表記は表示のときだけ使いましょう。

なぜプロダクトチームは+354番号に対してテストするのですか？

アイスランドは、ノルウェー、デンマーク、スウェーデン、フィンランドと並んで、北欧への展開に登場することがよくあります。また、旅行、予約、モビリティのアプリは、居住者だけでなく旅行者からも多く利用されます。チームは、ローンチ前に現地の顧客向けのサインアップのステップが動くことを確認するため、またアイスランド語のインターフェースでローカライズのQAを行うために、この国でテストします。

アイスランド語では、þ、ð、æなどの文字が使われます。コードのSMSがアイスランド語と英語のどちらで届くかはサービス次第で、アクセント付きのテキストによってメッセージのエンコードが切り替わることもあります。翻訳されたテンプレートがテストを壊さないよう、パーサーがパターンで数字を抽出するようにしてください。このチェックをどこに組み込むかは、CIパイプラインのガイドで紹介しています。

アイスランドの番号にコードが届かなかったら？

各アクティベーションには20分のウィンドウがあります。支払いが発生するのは、コードが届いたときだけです。期限切れまたはキャンセルされた注文は、お客様側で何も申請しなくても、全額がウォレットに返金されます。

• 試行が失敗したと判断する前に、ウィンドウが終わるまで待ちます。
• サービスが仮想番号を受け付けているか確認します。拒否するサービスもあります。
• 時間をおくか、別のサービスルートを使って再試行します。
• タイトなループで再注文せず、再試行のペースを抑えます。

開発者でない方も、これらすべてをダッシュボードから行えます。メールアドレスと6桁のメール確認コード、またはGoogleサインインでアカウントを作成し、TOTPをオンにしてチャージしたら、アイスランドとサービスを選び、表示された価格を確認して、画面でコードを読み取ってください。

アイスランドの番号を保持できますか？利用料金はどのように請求されますか？

アイスランドには、セルフサービスの長期番号はありません。専用回線は米国とカナダ向けの商品で、月額$1.95から、SMSの送受信とブラウザ発信に対応しています。長期利用できる+354の回線について問い合わせるには、[email protected] にメールしてください。提供可否は現地の規制によるもので、保証はできません。

利用分は、1つのプリペイドUSDウォレットから差し引かれます。従量課金で、月額料金もプランもありません。カード、またはUSDT/USDCでチャージでき、チャージのたびにPDFの請求書がメールで届きます。リクエストに応じて開発用アカウントに有効化できるサンドボックスモードでは、模擬の番号とコードが返されるため、ウォレットの残高を使わずにエンドツーエンドのテストができます。

+354番号は、自社のプロダクトとアカウントにのみ使い、各サービスの規約を守り、OTP Routeの利用規定（Acceptable Use Policy）が適用されることを忘れないでください。

よくある質問

アイスランドの電話番号には、先頭のゼロがありますか？

いいえ。アイスランドの番号にはトランクプレフィックスがないため、E.164形式は +354 に7桁の加入者番号を続けるだけです。

コードからアイスランドに対して送るべきIDは何ですか？

国IDとして is を使います。たとえば GET /api/v1/prices?country=is&service=discord のように指定します。

アイスランドのSMS認証コードはいくらですか？

1コード $0.20 からです。正確な価格はサービスによって異なり、GET /api/v1/prices からライブで返され、ダッシュボードにも表示されます。

+354番号を使った北欧向けのサインアップテストを、CIから実行できますか？

はい。パイプラインでアクティベーションを作成し、署名付きWebhookを待つかアクティベーションをポーリングして、失敗時にはキャンセルすれば、資金が戻ります。

アイスランドのコードが期限切れになったら、お金はどうなりますか？

自動でウォレットに戻ります。20分のウィンドウ内にSMSが届いたときだけ請求されます。

ステージングのログイン用に、月額制のアイスランドの番号は利用できますか？

セルフサービスでは提供していません。専用番号は米国とカナダのみです。アイスランドについて確認したい場合は、[email protected] にメールしてください。

アイスランドのコードの支払いにステーブルコインを使えますか？

はい。ウォレットはカード決済とUSDT/USDCに対応しており、チャージごとにPDFの請求書がメールで送られます。

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