開発者のためのラオス（+856）ワンタイムコード受信ルート

APIキーから+856のコードまで、最短の手順は？

まず開発者コンソールでBearerキー（or_live_で始まります）を作成します。1アカウントで10個まで作れるので、環境ごとに1つ持つとよいでしょう。リクエストはすべてhttps://otproute.com/api/v1に送り、ラオスの国IDはlaです。最小の流れは次のとおりです。

1. GET /api/v1/servicesでサービスIDを調べます。国IDはGET /api/v1/countriesで取得できます。
2. GET /api/v1/prices?country=la&service=<id>で、注文の料金と、その組み合わせが現時点で利用可能かを確認します。
3. POST /api/v1/activationsに{"service": "telegram", "country": "la"}のようなボディを渡してアクティベーションを作成します。レスポンスには、アクティベーションIDとラオスの番号が含まれます。
4. その番号をテスト対象のアプリに入力し、コードを待ちます。
5. テストが途中で打ち切られた場合は、POST /api/v1/activations/{id}/cancelで保留を解除します。

基本的なテストに必要なラオスのOTP APIは、これですべてです。レスポンスやエラーコードについては、開発者向け概要とドキュメント全文をご覧ください。

ラオスのテストスイートには、ポーリングとWebhookのどちらが向いているか？

単発のスクリプトなら、GET /api/v1/activations/{id}を数秒おきにポーリングするだけで十分です。1アカウントあたり1分300リクエストまでなので、並列ジョブが複数あっても余裕があります。規模の大きいスイートでは、プッシュ配信の方が向いています。最大5つのWebhookエンドポイントを追加し、activation.sms_received、activation.expired、activation.cancelledを待ち受けます。

受信側のハンドラーには3つの役割があります。1つ目は、エンドポイントのシークレットで<t>.<raw body>のHMAC-SHA256を計算し、X-OTPRoute-Signature（t=<unix>,v1=<hex>）を検証すること。2つ目は、古いタイムスタンプを拒否すること。3つ目は、アクティベーションIDを記録して冪等性を保ち、再送されたイベントが何も起こさないようにすることです。さらに詳しいパターンは、WebhookベースのOTPキャプチャの記事にあります。

ラオスの電話番号はどう表記され、コードは何語で届くのか？

国内では、ラオスの番号はトランクプレフィックスの0を付けてダイヤルし、国際形式ではその0が消えます。携帯番号は一般に国番号の後が20で始まるため、国内表記の020の番号は、E.164では+856 20に加入者番号の桁を続けた形になります。このE.164形式で保存し、正規化の際にトランクの0を取り除いてください。そうしないと、両方の書き方で登録された重複が、ユーザーテーブルの照合で見つからなくなります。

公用語はラオス語で、独自の文字を使います。ローカライズしたOTPテンプレートを送る製品では、ラオス文字がSMSのエンコードで正しく届くか、数字が見つけやすいままかを確認してください。長いUnicodeメッセージは複数に分割されることがあります。この市場でも、国際的なサービスの多くは認証メッセージを英語のままにしているため、パーサーはどちらにも対応できるようにしておきましょう。

プロダクトチームがラオスでテストを行う理由は？

ラオスはタイ、ベトナム、中国、カンボジア、ミャンマーと国境を接しており、地域向けのアプリの多くは、メコン地域全体への展開の一部としてラオスを扱っています。+856番号をテストに使いたくなるのは、ラオス語をローカライズリリースに加えるとき、国境を越えるウォレットや配送サービスを立ち上げるとき、ラオスと近隣市場を行き来するユーザーをサポートするときなどです。実際のラオスのルートでサインアップのフローを通せば、書式、レート制限、テンプレートの問題を、顧客から報告される前に見つけられます。市場ごとのOTPルーティングの判断については、国別ルーティングのガイドで解説しています。

+856のルートではどのサービスが利用できるのか？

laの現在のカタログには、1,700を超えるサービスが載っています。執筆時点で人気のあるものは、WhatsApp、Facebook、LINE、WeChat、TikTok、Telegram、Google（Gmail＆YouTube）、imo、Shopee、Lazada、Zalo、Instagram、ChatGPT（OpenAI）などです。提携先の容量に応じて利用可否は変わるため、実行のたびに価格エンドポイントで確かめてください。

コードを書かない場合のダッシュボードの流れは簡単です。サービスを選び、ラオスを選び、表示された価格を確認して注文し、アクティベーションカードにコードが現れるのを待ちます。

ラオスのコードが届かないときはどうすればよいか？

アクティベーションごとに、番号は20分間保持されます。料金が発生するのはコードが届いたときだけで、期限切れやキャンセルの場合は、金額が自動でウォレットに戻ります。

• ルートの失敗と判断する前に、ウィンドウの時間を最後まで使い切ります。
• 立て続けに再注文せず、間隔を空けるか、時間をおいてやり直します。
• 同じテストケースで何度もタイムアウトする場合は、別のサービスルートに切り替えます。
• アプリが仮想番号を受け付けるか確認します。はっきり拒否するところもあります。
• フォームが、トランクの0を付けたままにせず+856で送信しているかを確認します。

ラオスの固定回線、課金、サンドボックスについて

OTP Routeには、セルフサービスで利用できるラオスの長期番号はありません。Dedicated Numbersは米国とカナダ向けの製品で、$1.95/月からです。+856の回線が必要な場合は、[email protected]までメールをいただければ、現地の規則で可能かどうかをチームがお答えします。提供をお約束するものではありません。

支払いは、プリペイドのUSDウォレットによる従量課金です。サブスクリプションはなく、チャージはカードまたはUSDT/USDCで行え、そのたびにPDFの請求書がメールで届きます。CI用途では、開発用アカウントのサンドボックス切り替えをリクエストすれば、同じエンドポイントを通じて、無料で模擬の番号とコードが流れます。詳細は料金ページをご覧ください。

よくある質問

ラオスのSIMを持っていなくても、アプリのラオス向けサインアップを検証できるか？

はい。OTP Gatewayで+856番号を注文してサインアップ画面で使い、コードはAPI、Webhook、ダッシュボードのいずれかで受け取れます。

OTP Routeはラオスにどの国IDを使うか？

laです。価格クエリと、アクティベーションのリクエストボディで使います。

ラオスの番号は先頭の0を残すべきか？

国内ダイヤルの場合だけです。E.164でもデータベースでも0を外し、+856に国内番号を続けて保存してください。

ラオスの認証番号はいくらか？

$0.20/コードからです。正確な価格はサービスによって異なり、注文前にGET /api/v1/pricesで返されます。

コードが届かなかった場合、返金は自動か？

はい。20分以内にSMSが届かない場合、またはキャンセルした場合は、全額がウォレットに戻ります。

+856番号の許容される利用とは？

自社のラオス向けサインアップフローの検証と、事業として正当に所有するアカウントの運用です。OTP Routeでは、各サービスの規約とAcceptable Use Policyを守り、実在する1人または1事業者につき1アカウントとすることをお願いしています。

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