チームがテストと運用のために DiDi の SMS コードを受け取る方法

状況: 1 つの電話番号にかかっているモビリティアカウント

DiDi は配車・モビリティのプラットフォームで、この分野のほとんどのアプリと同様に、携帯電話番号をアカウントの中核として扱います。SMS コードは通常、サインアップ時、新しい端末でのログイン時、アカウントの復旧時に要求され、ドライバーや配達員のオンボーディングも同じチェックに頼っています。

これは正当な業務にとって、手間の原因になります。会社のライダーアカウントを運用する企業は、それを従業員 1 人の個人の電話に紐づけたくありません。クライアントの出張を管理する代理店には、最初にサインアップした人以外でも完了できる認証ステップが必要です。DiDi アカウントと連携するプロダクトを作っている QA チームは、個人の端末をオフィス内で回さずに、フローをリハーサルしたいと考えます。DiDi 用の仮想番号を認証 1 回につき 1 つ使えば、こうしたステップを誰かの私用 SIM から切り離せます。

DiDi の電話番号はどの国で入手できますか？

didi のルートは、現在 198 か国に及びます。チームは多くの場合、配車の需要が高い市場から始めます。メキシコ、ブラジル、チリ、コロンビア、ペルー、アルゼンチン、コスタリカ、パナマ、ドミニカ共和国、エクアドル、オーストラリア、ニュージーランド、日本、香港などです。

国は意識して選んでください。サンティアゴで使うライダーアカウントはチリの番号で認証すべきですし、メキシコのサインアップ画面の回帰テストにはメキシコの番号が必要です。番号の国とアカウントの市場が一致していないことは、テストが書類上は通るのに実際のアプリでは失敗する、よくある原因です。全一覧は国別ページにあります。

DiDi 認証コード API のフローはどのように動きますか？

DiDi のフローは、ほかのルートと同じベース URL の https://otproute.com/api/v1 を使い、Authorization ヘッダーに or_live_ のキーを指定します。

1. GET /api/v1/prices?country=<id>&service=didi で、ルートが開いているかと現在の料金を確認します。
2. {"service": "didi", "country": "mx"} のようなボディで POST /api/v1/activations を呼び出して注文します。
3. 返された番号を、テスト対象の DiDi の画面に入力し、SMS を要求します。
4. Webhook からコードを読み取るか、表示されるまで GET /api/v1/activations/{id} をポーリングします。
5. 配車予約のテストを途中で中止する場合は、POST /api/v1/activations/{id}/cancel で番号を解放します。

1 アカウントにつき、API キー最大 10 個、Webhook エンドポイント最大 5 個を、1 分あたり 300 リクエストの範囲で持てます。

DiDi の Webhook ハンドラーはどう書くべきですか？

activation.sms_received を購読し、あわせて activation.expired と activation.cancelled も購読して、テストがいつ待機を止めるべきかを把握できるようにします。すべての配信には X-OTPRoute-Signature: t=<unix>,v1=<hex> が付いています。エンドポイントのシークレットで "<t>.<raw body>" に対する HMAC-SHA256 を再計算し、定数時間で比較し、古いタイムスタンプのものは破棄してください。

イベントはアクティベーション ID をキーにしているため、注文時にその ID を保存し、同じ ID に対する 2 回目の配信は何もしないものとして扱います。この冪等性が重要なのは、再試行された Webhook で DiDi のコードが 2 回送信されることがあってはならないからです。環境の都合で受信 Webhook が扱いにくい場合は、アクティベーションのエンドポイントをポーリングする方法でも対応できます。両方のアプローチは、Webhook による OTP 取得の記事で比較しています。

ダッシュボードで DiDi の OTP を受け取る

運用スタッフは、API をまったく使わずに済みます。サインインしてウォレットにチャージし、OTP Gateway を開き、DiDi を検索し、アカウントに合う国を選び、確定する前に表示された料金を確認します。番号はアクティベーションカードに表示され、DiDi がコードを送信すると、そこにコードが表示されます。アクティベーションは 20 分間開いています。

DiDi のコードが届かないのはなぜですか？

アクティベーションが空のままになるのには、いくつかのありふれた理由があります。

• DiDi も多くのプラットフォームと同様に、一部のルートや一部の時間帯では仮想番号を拒否することがあります。
• 選んだ国のルートが混雑していることがあり、提供状況は 1 日を通して変わります。
• テスト中、同じ端末やセッションからの繰り返しの要求を、アプリがスロットリングすることがあります。

対処は、強引ではなく辛抱強くすることです。ウィンドウが終わるまで待ち、時間を置くか、テストに合う別の国で試し、短い間隔での再注文は避けてください。未着の分を支払うことはありません。ウィンドウが閉じたときやキャンセルしたときに、全額が自動的にウォレットに戻ります。

DiDi アカウントはどんなときに Dedicated Number に置くべきで、どんなルールが適用されますか？

ワンタイムのアクティベーションは、1 回の認証に向いています。ステージングのライダーアカウントや共有の会社ログインのように、同じ DiDi アカウントが来月もログインしなければならない場合、Dedicated Number なら回線をご自身の管理下に置けます。提供は米国とカナダのみで、1 か月 $1.95 からです。受信 SMS はダッシュボードと Webhook で受け取れます。詳細は仮想番号をご覧ください。

OTP Route は、ご自身の正当なプロダクトとアカウントのテストと運用にのみ使ってください。DiDi の規約を守り、アカウントは実在する 1 人または 1 社につき 1 つとし、OTP Route の Acceptable Use Policy が適用されることにご注意ください。OTP Route は DiDi と提携しておらず、DiDi の名称は所有者の商標です。

よくある質問

DiDi の SMS 認証テストのサービス ID は何ですか？

service フィールドに didi を、テストする市場の国 ID とあわせて指定します。

メキシコの SIM なしで、メキシコのアカウント用の DiDi の OTP を受け取れますか？

はい。メキシコのルートが開いていれば、国に mx、サービスに didi を指定して番号を注文し、API またはダッシュボードでコードを確認します。

DiDi がコードを送ってこなければ、支払う必要がありますか？

いいえ。20 分以内に SMS が届かなかったアクティベーションや、キャンセルしたアクティベーションは、ウォレットに全額返金されます。

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

必ずしもそうではありません。一部のルートは拒否されることがあるため、時間を置くか、別の適切な国で再試行してください。

ウォレットの資金を使わずに DiDi の連携をテストできますか？

はい。リクエストに応じて開発用アカウントをサンドボックスに切り替えられ、エンドツーエンドのテスト用にシミュレートされた番号とコードが返されます。

DiDi のアクティベーションの料金はどのように支払いますか？

前払いの USD ウォレットをカードまたは USDT/USDC でチャージします。月額料金はなく、チャージごとに PDF の請求書が発行されます。現在の料金は料金ページにあります。

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