サモアOTP API:太平洋地域の+685サインアップをテスト

プロダクト/QAチーム向け:サモアの基本情報

サモアは太平洋に浮かぶ独立国で、公用語はサモア語と英語です。ニュージーランド、オーストラリア、米国に多くのサモア系コミュニティがあるため、送金、メッセージング、旅行系アプリでは、これらの国と本国を行き来するユーザーへの対応が求められることがよくあります。

知っておきたい注意点が2つあります。1つ目は、サモア(+685)とアメリカ領サモアは別物だということです。アメリカ領サモアは北米番号計画に含まれ、+1 684を使います。国選択UIで取り違えると、コードが誤った宛先に送られてしまいます。2つ目は、サモアが2011年に国際日付変更線の西側へ移り、UTCよりかなり進んだ時刻を使っていることです。有効期限ロジックの日付境界をテストするうえで好都合なケースになります。

プロダクトチームにとって、サモア単独で進出先になることはあまりありません。多くは太平洋地域への展開の一部として、ディアスポラ向けアプリの要件として、あるいはアピアのパートナー組織のビジネスアカウントを確認する必要があって登場します。いずれの場合も目的は同じで、+685のユーザーがサインアップフローを最後まで完了できることを確かめることです。

+685の番号はコードでどう扱うべきですか?

サモアの国内番号は他の多くの市場に比べて短いため、9桁や10桁を想定したバリデーターでは正しい番号が弾かれることがあります。番号は+685に国内桁をそのまま続け、区切り文字なしで保存してください。習慣で入力された先頭のゼロは取り除きます。WebhookのタイムスタンプはUnix秒なので、ローカル時間ではなくUTCで比較してください。サーバーとサモア在住のテスターで暦の日付がずれても影響を受けずに済みます。

プロフィール上でニュージーランドの番号とサモアの番号を切り替えられるプロダクトでは、国コードを変更したときに以前の認証状態が消えることを確認するテストを追加しましょう。一方の番号に送ったコードが、もう一方の番号で受理されることがあってはなりません。

サモアのルートで利用できるサービスは?

サモアのカタログには現在600を超えるサービスが載っています。よくリクエストされるものとして、WhatsApp、Facebook、Instagram、Telegram、Google (Gmail & YouTube)、Viber、Signal、TikTok、Microsoft & Outlook、Amazon、Discordなどがあります。大規模な市場に比べるとカバー範囲は狭く、日中にも変動するため、実行のたびにGET /api/v1/servicesとGET /api/v1/countriesを確認してください。目的のサービスがない場合は、フィジーやトンガといった近隣のルートでテストが成立することもあります。

カタログが軽めである以上、テストハーネスには柔軟さを持たせるとよいでしょう。実行時に希望のサービスが見つからなければ、失敗ではなくスキップとして扱い、後で誰かが再試行できるよう記録しておきます。

APIでサモアのコードをリクエストする

https://otproute.com/api/v1に対してBearerキー(or_live_…)を使い、まずGET /api/v1/prices?country=ws&service=<id>で価格を確認します。続いてPOST /api/v1/activationsに{"service": "<id>", "country": "ws"}を送信してください。アクティベーションIDは、GET /api/v1/activations/{id}のポーリング、またはactivation.sms_receivedの待ち受けで追跡できます。各WebhookではX-OTPRoute-SignatureのHMACを検証し、古いタイムスタンプは拒否し、同じアクティベーションに対して2回実行されても安全なハンドラーにしてください。全体の流れは連携ガイドで紹介しています。

この規模の市場であればレート制限に余裕があります。アカウントごとにキー10個、Webhookエンドポイント5つ、毎分300リクエストまで利用できます。ポーリングなら、数秒おきの確認で十分です。

ダッシュボードで手作業で行う

1. サインインして、OTP Gatewayを開きます。
2. サービスを選び、次にサモアを選びます。
3. 表示された最新の価格を確認して、注文を確定します。
4. +685の番号をテスト対象のアプリに貼り付けて、コードを送信させます。
5. 画面に表示されたコードを確認します。不要になった場合はキャンセルします。

+685のコードが遅い、または届かないとき

あきらめる前に、アクティベーションを20分間フルに開いたままにしてください。アプリによっては仮想番号を一切受け付けないことがあり、応答のなかった注文が返金されるのはそのためです。ルートが無反応のままなら、時間を置くか別のサービスルートを選んでください。短時間に注文を連発してもまず効果はなく、レート制限を消費するだけです。

試行ごとにアクティベーションIDをログに残しておくと、無反応の原因が特定のアプリにあるのか、ルート全体にあるのかを見分けられます。

長期用の番号と利用料金について

OTP Routeでは、サモアの長期用番号をセルフサービスでは提供していません。Dedicated Numbersは月額$1.95からで、米国とカナダに限られます。サモアの回線が必要な場合は[email protected]までお問い合わせください。ただし、ご用意できる保証はありません。前払いのUSDウォレットはカードとUSDT/USDCに対応し、チャージごとにPDFの請求書を送付します。月額料金はかかりません。開発アカウントでサンドボックスモードをリクエストすれば、資金を使わずにwsのフローをリハーサルできます。

よくある質問

電話番号の観点で、サモアとアメリカ領サモアは同じですか?

いいえ。サモアは+685、アメリカ領サモアは+1 684です。国選択UIとAPIでは、正しい方を指定してください。

サモアのAPI国IDは何ですか?

価格の問い合わせとアクティベーションのリクエストではwsを使います。

サモアの認証コードはいくらですか?

1コード$0.20〜です。正確な価格はサービスによって異なり、注文前に表示されます。

ニュージーランドやオーストラリアから、サモア人ユーザーのサインアップをテストできますか?

はい。+685の番号がSMSを受信し、OTP Routeはチームがどこにいても画面に表示します。

メッセージが届かなかった場合、料金は発生しますか?

いいえ。期限切れまたはキャンセルされたアクティベーションは、自動的にウォレットへ返金されます。

サモアのコードは何語で届きますか?

たいていは英語で、サモア語と並ぶ公用語です。周囲の文面ではなく、数字を解析してください。

これらの番号を使ってアカウントを大量に作成できますか?

いいえ。各サービスの利用規約を守ってください。利用規約(Acceptable Use Policy)により、OTP Routeの用途は、ご自身の正当なアカウントやプロダクトのテストと運用に限られます。

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