API で Gojek の電話認証コードを受け取る

Gojek は電話番号をどのように使いますか？

Gojek はインドネシアのバイクタクシー配車サービスとして始まり、配車、フードデリバリー、荷物の配送、決済を扱うスーパーアプリへと成長し、現在は Tokopedia と同じグループに属しています。電話番号は Gojek アカウントの中心です。ログイン ID であり、登録時にワンタイムコードで確認され、新しい端末でサインインしたときや番号を変更したときにも別のコードが要求されます。

そのため、Gojek と連携したりユーザーをサポートしたりする人は、テスト用の Gojek の電話番号を必要とすることになります。アプリで配信方法を選べる場合は SMS を選んでください。OTP Gateway の番号が受信できるのはテキストメッセージだからです。

チームが Gojek の SMS 認証テストを依頼する典型的な理由は次のとおりです。

• 加盟店連携やロイヤルティ連携のようなパートナー連携で、ステージングの実行に新しい Gojek ログインが必要な場合。
• サポートスタッフが、自分たちで管理するクリーンなアカウントで、顧客のログインの問題を再現する場合。
• コード入力画面と再送タイマーが、インドネシア語と英語でどう見えるかを確認するローカライズチェック。

Gojek のテスト用番号の国が重要なのはなぜですか？

gojek サービスは OTP Route で 197 か国に掲載されていますが、適切な国は何を確認したいかによって変わります。実際の Gojek アカウントのほとんどはインドネシアのものなので、インドネシア（+62）が自然な既定の選択です。インドネシアの携帯電話番号は国内では 08… と書かれ、先頭のゼロを外して E.164 形式では +62 8… になります。インドネシアのアカウントの認証テキストは、通常はインドネシア語で届きます。

そのほかのルートには、シンガポール、マレーシア、ベトナム、フィリピン、タイ、インド、オーストラリア、日本、イギリス、アメリカ、ブラジルがあります。東南アジア以外の番号は、旅行者や未対応地域でのサインアップの挙動を確認したいときに役立ちます。選び方は国別ルーティングの記事で解説しています。

gojek サービスの API フローはどうなっていますか？

リクエストは https://otproute.com/api/v1 に、or_live_ で始まる Bearer キーを付けて送ります。

1. GET /api/v1/prices?country=id&service=gojek で、インドネシアのルートのリアルタイムの料金と提供状況を確認します。
2. 注文を作成します: POST /api/v1/activations に {"service": "gojek", "country": "id"} を送ります。アクティベーション ID を保存します。
3. 返された番号を Gojek アプリに入力し、コードを要求します。
4. Webhook に届く activation.sms_received からコードを受け取るか、GET /api/v1/activations/{id} をポーリングします。
5. テストを中止する場合は POST /api/v1/activations/{id}/cancel を呼び出します。

Webhook では、エンドポイントのシークレットで <t>.<raw body> に対する HMAC-SHA256 を計算して X-OTPRoute-Signature ヘッダー（t=<unix>,v1=<hex>）を検証し、古いタイムスタンプは破棄します。配信は再試行されることがあるため、ハンドラーはアクティベーション ID をキーにして冪等にし、重複は無視してください。単発の実行であれば、1 分あたり 300 リクエストの上限内でのポーリングで問題ありません。完全なリファレンスはドキュメントをご覧ください。

代わりにダッシュボードで Gojek の OTP を受け取れますか？

はい。サービスに Gojek を選び、国を選び、表示された料金を確認して注文します。番号をアプリに入力し、コード送信をタップして、アクティベーションカードを見ていると、SMS が届いた時点でそこに表示されます。注文は 20 分間有効で、何も届かない場合やキャンセルした場合は、全額がウォレットに戻ります。

Gojek の SMS が届かないのはなぜですか？

よくある原因がいくつかあります。

• Gojek も多くのアプリと同様に、仮想番号を拒否したり追加の確認を求めたりすることがあります。コードが届かなければ課金されません。
• アプリが SMS 以外の経路でコードを送った可能性があります。
• ルートが混雑していることがあります。ウィンドウが終わるまで待ってから、時間を置くか別の国で再試行してください。
• 短時間での繰り返しの要求は、アプリ自身のクールダウンを招くことがあるため、ループさせずに試行の間隔を空けてください。

専用番号のほうが適しているのはどんなときですか？

ワンタイム番号は、コード 1 つ分です。Gojek のテストや運用のアカウントが引き続きログインしなければならない場合は、長期の SMS が使える Dedicated Number のほうが適している場合がありますが、提供は米国とカナダのみ、1 か月 $1.95 からで、アカウントが米国またはカナダの番号を受け付ける場合にのみ役立ちます。両方の選択肢は一時的な番号と専用番号の違いで比較しています。

Gojek のテストを責任を持って行うには？

Gojek の規約を守ってください。アカウントは実在する 1 人または 1 社につき 1 つとし、番号は自社プロダクトのフローのテスト、またはご自身の正当なアカウントの運用にのみ使い、追加のアカウントの作成やサインアップのプロモーションの獲得には決して使わないでください。OTP Route は Gojek と提携していません。この名称は所有者の商標であり、すべての注文に OTP Route の Acceptable Use Policy が適用されます。

よくある質問

インドネシアの SIM なしで Gojek の OTP を受け取れますか？

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

OTP Route の API で Gojek のサービス ID は何ですか？

gojek です。インドネシアなら id のような国 ID と組み合わせます。

Gojek 用の仮想番号は毎回受け付けられますか？

いいえ。Gojek が一部の仮想番号を拒否することがあります。そのため、コードが届かなかったアクティベーションは自動的に返金されます。

Gojek のアクティベーションはどのくらいの間、開いていますか？

20 分間です。その間に SMS が届かない場合やキャンセルした場合は、料金がウォレットに戻ります。

あとで同じ番号を使って Gojek にログインできますか？

OTP Gateway では使えません。番号 1 つにつきコード 1 つが対象です。繰り返しのログインには、アカウントが許可する場合に、米国またはカナダの Dedicated Number を検討してください。

Gojek のコードの Webhook の重複処理を避けるには？

署名を検証してから、アクティベーション ID を保存し、すでに処理したイベントは無視します。

お金をかけずにテストできますか？

はい。リクエストに応じて、開発用アカウントをサンドボックスに移行でき、シミュレートされた番号とコードが返されます。

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