OTP Route の番号で Swiggy の電話認証をテストする

Swiggy はいつワンタイムコードを送るのか？

インドのフードデリバリー・クイックコマースアプリである Swiggy は、携帯番号をアカウントの識別子として扱います。サインアップ、新しい電話でのログイン、アプリの再インストール、登録済みの番号の更新はいずれも、長期間有効なパスワードではなく、SMS のワンタイムパスワードに依存しています。

だからこそ、チームは自分たちで管理できる Swiggy 用の電話番号を探します。オフィスの注文用に共有ビジネスアカウントを運用する運用チーム、キャンペーンのランディングフローを最初から最後まで確認するエージェンシー、自社プロダクトの引き継ぎをテストしながら、ユーザー側から認証ステップを確認したい QA エンジニアなどです。

Swiggy 用の仮想番号はどの国のものにすべきか？

swiggy ルートは 201 か国で提供されており、インド、アラブ首長国連邦、英国、シンガポール、ネパール、スリランカのほか、バングラデシュ、マレーシア、オーストラリア、カナダ、米国、サウジアラビア、カタール、ドイツなどがあります。

Swiggy 自身のサービスはインドが中心なので、通常は +91 の番号がアカウントの対象市場に合います。海外のユーザーが外国の番号を入力するというテストケースでは他のルートも役立ちますが、その番号を Swiggy が受け付けるかどうかは Swiggy が決めることで、私たちが決めることではありません。シナリオが実際に想定している国を選んでください。

インドの携帯番号は 10 桁で、E.164 形式では +91 の後にその 10 桁が続きます。自社のシステムでテストアカウントを保存する場合は、この標準形式で保存しておくと、後の復旧テストで同じ番号を確実に見つけられます。どのアクティベーション ID がどのコードを生んだかも記録しておいてください。

Swiggy 認証コード API の流れは？

1. GET /api/v1/prices?country=in&service=swiggy で費用を確認します。
2. POST /api/v1/activations に {"service": "swiggy", "country": "in"} を送って注文し、アクティベーション ID を保管します。
3. Swiggy のログイン画面に番号を入力します。
4. Webhook で activation.sms_received を受け取ります。X-OTPRoute-Signature は、エンドポイントのシークレットでタイムスタンプ、ドット、生の本文に対する HMAC-SHA256 を計算して検証し、古いタイムスタンプは破棄してください。
5. 配信が再試行されることがあるため、アクティベーション ID をキーにしてハンドラーを冪等にします。

ポーリングのほうがよければ、代わりに GET /api/v1/activations/{id} を無理のない間隔で呼び出してください。キーのプレフィックスは or_live_ で、1 アカウントにつきキー 10 個、Webhook エンドポイント 5 個を保持でき、上限は 1 分あたり 300 リクエストです。ドキュメントと Webhook によるコード取得の解説をご覧ください。

ダッシュボードから Swiggy の OTP を受け取るには？

サインインして、サービスに Swiggy、続けて国を選び、画面の価格を確認して注文します。番号を Swiggy に貼り付けてコードを要求すると、SMS が届いた時点でダッシュボードの番号の横にコードが表示されます。この方法ではプログラミングは不要なので、1 回の認証を済ませたいだけのサポートや運用のスタッフに向いています。注文とそのコードは API からも確認できるため、開発者が後から何が起きたかを監査することもできます。

Swiggy のコードが届かないのはなぜか？

アクティベーションの有効時間は 20 分で、コードが届いた場合にのみ課金されます。期限切れまたはキャンセルされた注文は、全額がウォレットに返金されます。反応がない主な理由は次のとおりです。

• Swiggy が仮想番号や特定の番号帯を受け付けない場合があります。
• ルートが一時的に遅いことがあります。短い間隔で再注文を繰り返さず、時間をおいて再試行してください。
• テストしているフローに国が合っていません。シナリオに合うルートを試してください。

再試行の設計については、OTP 配信失敗を減らすためのノートでさらに詳しく解説しています。

ワンタイムのアクティベーションより専用番号が適しているのはどんなときか？

Gateway の番号で受け取れるのはコード 1 件分です。数週間後にアカウントが再ログインする必要があるなら、保持できる番号のほうが重要です。専用番号は米国とカナダでのみ即時に利用でき、月額 $1.95 からで、受信 SMS はダッシュボードと Webhook で確認できます。Swiggy の場合、米国またはカナダの番号が本当にアカウントに合うときにだけ役立ちますが、それを判断するのは Swiggy 自身です。

OTP Route の料金は、月額料金のないプリペイド式 USD ウォレットから支払われます。カードまたは USDT/USDC でチャージでき、そのたびに PDF の請求書が発行されます。サンドボックスモードは、統合テスト向けに申請により利用できます。Swiggy の規約に従い、アカウントは実在する個人または事業者 1 つにつき 1 つとし、OTP Route は利用規約（Acceptable Use Policy）の範囲内で、テストと、自社の正当なアカウントやプロダクトの運用にのみご利用ください。

よくある質問

インドの SIM カードなしで Swiggy の OTP を受信できますか？

はい。OTP Gateway で swiggy サービスのインドの番号を注文し、ダッシュボードまたは API でコードを確認できます。

API で Swiggy のサービス ID は何ですか？

サービス ID は swiggy です。アクティベーションのリクエストで、in などの国 ID と組み合わせて使います。

Swiggy はすべての仮想番号を受け付けますか？

いいえ。どの番号を受け付けるかは Swiggy が決めます。20 分以内にコードが届かなければ、全額がウォレットに戻ります。

Swiggy の認証用番号はいくらですか？

1 コード $0.20 からです。実際の価格は国によって異なり、注文前に表示されます。料金の仕組みは料金ページで説明しています。

その番号で、来月も同じ Swiggy アカウントにサインインできますか？

通常はできません。Gateway の番号は 1 回のコード専用だからです。復旧には、事業側で保持している番号を計画しておいてください。

CI パイプライン内でテスト用に Swiggy の SMS 認証を行えますか？

はい。注文と Webhook によるコード取得はテストジョブから実行できます。拒否された番号で大量の再試行が発生しないよう、試行の間にバックオフを入れてください。

これらの番号で Swiggy のアカウントを複数開設してもよいですか？

いいえ。アカウントは実在する個人または事業者 1 つにつき 1 つとし、Swiggy の規約と当社の利用規約（Acceptable Use Policy）の範囲内でご利用ください。

OTP Route は Swiggy と提携していますか？

いいえ。Swiggy はその所有者の商標であり、OTP Route は Swiggy と提携関係にありません。

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