日本語
OTP Route の番号で Bolt の SMS コードを受け取るためのチェックリスト
OTP Route で Bolt の認証コードを受け取るには、アカウントが属する国で bolt サービス用のワンタイム番号を注文し、Bolt アプリに入力して、ダッシュボードでコードを確認するか、Webhook またはポーリングで API から取得します。料金は 1 コード $0.20 からで、20 分のウィンドウ内に SMS が届かなければ全額が返金されます。
Bolt はどこで電話番号を求めますか?
Bolt はタリン発祥のモビリティ企業で、配車、フード・食料品の配達、スクーターのレンタルを手がけており、アカウントは携帯電話番号を軸に作られています。ライダーアプリでは、登録時にワンタイムの SMS コードでその番号を確認し、新しい端末でサインインするときやアクセスを復旧するときにも、通常は同じようなコードが再び要求されます。ドライバー、配達員、法人向けのプロダクトも、似たパターンです。
企業にとって、これは Bolt の電話番号が事実上アカウントの鍵であることを意味します。会社の出張用アカウントを運用するチーム、新しい都市で自社のパートナー連携がどう動作するかを確認するチーム、共有の業務ログインに社員の個人 SIM を使わないようにしたいチームは、そのコードを受け取る管理された手段を必要とします。
Bolt の番号を注文する前の事前チェックリスト
費用をかける前に、次を確認してください。
- 目的が正当である: アカウントが自社の組織のものか自社プロダクトのテストアカウントであり、Bolt の規約で認められていること。
- 市場が決まっている: 番号の国が、アカウントを運用する場所と一致していること。ある国の番号で登録したライダーアカウントを別の場所で使うと、挙動が異なることがあります。
- API キーが準備できている: 開発者コンソールで作成した、
or_live_プレフィックスの Bearer キー(1 アカウントにつき最大 10 個)。 - Webhook エンドポイントがテスト済み:
activation.sms_receivedを購読し、署名の確認が有効になっていること。 - ウォレットに資金がある:
GET /api/v1/balanceで確認するか、サンドボックスモードを依頼して、シミュレートされた番号でフローをリハーサルすること。 - フォールバックが合意されている: コードが返ってこなかった場合にテストがどうするかを、事前に決めておくこと。
Bolt のルートがある国はどこですか?
Bolt のルートは、現在 198 か国で掲載されています。例として、エストニア、ラトビア、リトアニア、ポーランド、チェコ、ポルトガル、ドイツ、クロアチア、マルタ、ジョージア、南アフリカ、ナイジェリア、ケニア、ガーナ、タンザニア、ウガンダがあります。
国は意識して選んでください。Bolt の機能、支払い方法、サインアップのチェックは市場ごとに異なるため、ワルシャワでのテストは、ナイロビでのフローについてほとんど何も教えてくれません。国ごとの提供状況は 1 日の中で変わります。現状は GET /api/v1/prices とダッシュボードで確認できます。
手順で見る Bolt 認証コード API
GET /api/v1/servicesでサービス ID を確認します。Bolt の場合はboltです。GET /api/v1/countriesから国 ID を選びます。たとえばエストニアならeeです。GET /api/v1/prices?country=ee&service=boltでリアルタイムの料金を取得します。- 注文します:
POST /api/v1/activationsに{"service": "bolt", "country": "ee"}を送ります。アクティベーション ID と、返された番号を保存します。 - 番号をテスト端末の Bolt アプリに入力し、SMS を要求します。
activation.sms_receivedイベントを処理します。エンドポイントのシークレットで<t>.<raw body>に対する HMAC-SHA256 を計算してX-OTPRoute-Signature: t=<unix>,v1=<hex>を検証し、古いタイムスタンプを拒否し、書き込みはアクティベーション ID をキーにして、配信が繰り返されても何も変わらないようにします。- Webhook が使えない場合は、1 分あたり 300 リクエストの上限に十分収まる範囲で、数秒ごとに
GET /api/v1/activations/{id}をポーリングします。 - テストを中止する場合は
POST /api/v1/activations/{id}/cancelを呼び出します。
エンドポイントの詳細は API ドキュメントにあり、署名の確認については OTP Webhook の保護で解説しています。
手順で見る、ダッシュボードでの方法
Bolt の SMS 認証テストを 1 回行う場合や、アカウントを一度だけセットアップする場合は、ブラウザだけで十分です。サインインして OTP Gateway を開き、Bolt と市場を選び、料金を確認して確定します。番号をアプリにコピーしてコードを要求し、20 分のタイマーが切れる前に、注文カードにコードが表示されるのを見守ります。
トラブルシューティング: Bolt のコードが届かなかった
空のウィンドウに費用はかかりません。SMS が届かないまま 20 分が経過した場合やキャンセルした場合は、全額がウォレットに戻ります。よくある原因と対処は次のとおりです。
- Bolt が番号を拒否した: 多くのプラットフォームと同様に、Bolt はすべての市場で Bolt のサインアップ用の仮想番号を受け付けるわけではありません。テストが許すなら別の国のルートを、あるいは後でもう一度試してください。
- 配信が遅い: 所要時間はサービスとルートによって変わるため、キャンセルする前にウィンドウが終わるのを待ってください。
- 繰り返しの要求: 再送を何度も押したり、ループで再注文したりすると、Bolt 自身のスロットリングを招くことがあります。試行の間隔を空けてください。
- 市場の不一致: テストシナリオで Bolt が提供していない国の番号は、受け付けられないことがあります。
フォールバックの選び方については、OTP の国別ルーティングのガイドで扱っています。
Dedicated Number のほうが適しているのはどんなときですか?
ワンタイム番号は、1 回の認証に向いています。QA チームが再利用するステージングのライダープロフィールや、新しい端末で再認証される運用ログインのように、Bolt アカウントが数週間後に再びサインインしなければならない場合は、その番号を手元に残しておく必要があります。Dedicated Number はそれを実現しますが、米国とカナダのみで、1 か月 $1.95 からです。受信 SMS はダッシュボードに表示され、number.sms_received として Webhook にも転送されます。頼る前に、アカウントの Bolt の市場が米国またはカナダの番号で動作することを確認してください。詳細は仮想番号をご覧ください。
Bolt の番号を責任を持って使う
どの市場でも、Bolt の利用規約を守ってください。アカウントは実在する 1 人または 1 社につき 1 つとし、OTP Route は自社プロダクトのテスト、または組織が所有する正当なアカウントの運用にのみ使ってください。使い捨てのライダープロフィールを作ったり、プロモーションを稼いだりすることは、許容される利用ではありません。すべての注文に OTP Route の Acceptable Use Policy が適用されます。Bolt は所有者の商標であり、提携を意味するものではありません。
よくある質問
現地の SIM カードなしで Bolt の OTP を受け取れますか?
はい。適切な国で bolt サービスの番号を注文し、アプリに入力して、ダッシュボードまたは API でコードを確認します。
API で Bolt のサービス ID は何ですか?
bolt です。POST /api/v1/activations を呼び出すときに、pl や ke のような国 ID と組み合わせます。
Bolt の認証用番号はいくらですか?
1 コード $0.20 からです。正確な金額は国によって異なり、GET /api/v1/prices からリアルタイムで返されます。
Bolt はすべての仮想番号を受け付けますか?
いいえ。Bolt は、一部の市場やフローで仮想番号を拒否することがあります。そのため、届かなかったコードは自動的に返金されます。
Bolt のテストにはどの国を選ぶべきですか?
アカウントを実際に使う国を使ってください。そうすれば、サインアップのルール、言語、支払い方法が、実際のユーザーが目にするものと一致します。
今後の Bolt ログインのために同じ番号を保持できますか?
1 回限りのアクティベーションでは保持できません。繰り返しのログインには、セルフサービスで使える選択肢として、米国またはカナダの Dedicated Number があります。
支払う前にフローをテストできますか?
はい。開発用アカウントでサンドボックスモードを依頼すると、ウォレットの資金を使わずに、シミュレートされた番号とコードを受け取れます。
サービス名はそれぞれの所有者の商標です。OTP Route はこれらの企業と提携していません。番号は合法的にご利用いただき、各サービスの利用規約および当社の利用規定に従ってください。