APIで制御する認証番号でCareemのOTPを受信する

Careem認証コードAPIの呼び出し手順は?

すべてのリクエストは https://otproute.com/api/v1 に対し、Developerコンソールで発行した or_live_ で始まるBearerキーを付けて送ります。Careemの場合、流れは短く済みます。

1. GET /api/v1/prices?country=ae&service=careem で、UAE番号のリアルタイム価格を取得します。テスト対象の市場に合わせて国IDを差し替えてください。
2. POST /api/v1/activations に {"service": "careem", "country": "ae"} を送ると、アクティベーションIDと番号が返ります。
3. テスト端末またはエミュレーターが、その番号をCareemの電話番号入力画面に入力します。
4. コードはWebhookまたはポーリングで届き、スクリプトがそれを送信します。
5. コードが必要になる前に実行が中断された場合は、POST /api/v1/activations/{id}/cancel でアクティベーションを解放します。

アカウントの上限はAPIキー10個、Webhookエンドポイント5つ、毎分300リクエストで、並列のテストマトリクスにも十分です。エンドポイントの詳細はドキュメントをご覧ください。

WebhookハンドラーでCareemのコードを処理するには?

エンドポイントを activation.sms_received、activation.expired、activation.cancelled に登録します。各配信には X-OTPRoute-Signature: t=<unix>,v1=<hex> が付きます。そのエンドポイントのシークレットで <t>.<raw body> のHMAC-SHA256を計算し、定数時間で比較し、許容範囲を外れたタイムスタンプは拒否してください。詳細はHMAC Webhookガイドで解説しています。

再送された配信でコードが二重に送信されないよう、書き込みをアクティベーションIDで管理して、ハンドラーを冪等にしてください。2xxは素早く返し、時間のかかる処理はキューに渡します。

単発のテストならポーリングのほうが簡単です。コードが現れるか、アクティベーションが期限切れになったと報告されるまで、数秒おきに GET /api/v1/activations/{id} を呼び出します。

Careemが電話番号を求めるのはどんなときですか?

Careemはドバイを拠点とするライドシェア・日常サービスアプリで、湾岸諸国、中東全域、パキスタンで特によく知られています。多くの配車アプリと同様、携帯電話番号がアカウントの中核の識別子で、通常はサインアップ時にコードが送信され、新しい端末でのログインやアクセス回復のときにも再度送られます。ドライバーやサポート担当者も、乗車中に利用者へ連絡するためにこの番号を使います。

QAチームにとって、電話番号の手順はテストすべきあらゆるジャーニーの最初の関門になります。新規ライダーのオンボーディングから、新しいノートPCでサインインする法人向け出張管理者まで、すべてがここを通ります。

Careemの電話番号はどの国のものを選ぶべきですか?

Careemのルートは現在197の国と地域に対応していますが、実際に選ぶべきなのは、アカウントやテストケースが属する市場です。リヤドのライダープロフィールにはサウジアラビアの番号を、カラチやラホールでのライダーのオンボーディングテストにはパキスタンの番号を使うのが自然です。よく使われる選択肢は次のとおりです。

• アラブ首長国連邦(ae)とサウジアラビア(sa)
• パキスタン、ヨルダン、カタール、エジプト
• 地域内のその他のフローには、クウェート、バーレーン、オマーン、モロッコ
• 旅行者やディアスポラのシナリオには、トルコ、英国、インド、ケニア

最初の国の在庫が不足している場合のフォールバックの選び方は、国別ルーティングの記事で解説しています。

ダッシュボードからCareemのコードを取得するには?

OTP Gatewayを開き、サービスにCareemを、国に必要な国を選んで、表示された価格を確認します。番号を注文してCareemアプリに入力し、アクティベーションカードを開いたままにしておくと、コードを受信した時点でそこに表示されます。番号は、そのコード1回分に限り有効です。

Careemのコードが届かないのはなぜですか?

Careemは独自のリスクチェックに基づいて仮想番号を拒否する場合があり、その挙動は予告なく変わることがあります。だからこそ返金の仕組みがあります。20分の有効時間内にSMSが届かない場合、またはキャンセルした場合は、料金が自動的にウォレットへ戻ります。

• 再度注文する前に、有効時間が終わるまで待ちます。
• 時間を置いて再試行するか、シナリオに合う別の国で試します。
• 番号が国際形式のフルフォーマットで送信されたことを確認します。
• CIからの連続注文でルートに負荷をかけないよう、バックオフを入れてください。

長期間使うCareemのログインは、専用番号に置くべきですか?

OTP Gatewayの番号が扱えるのは1回分のコードだけです。Careemの法人アカウントや長期運用するステージングプロファイルが数週間後に再ログインする必要があるなら、更新される間は同じ回線を保持できる専用番号が向いています。専用番号は米国とカナダでのみ即時に利用でき、月額$1.95からで、受信SMSはダッシュボードと number.sms_received Webhookの両方で確認できます。詳しくは仮想番号をご覧ください。

支払いは前払い式のUSDウォレットで、カードまたはUSDT/USDCでチャージします。チャージごとにPDFの請求書が発行され、月額料金はありません。開発アカウントはサンドボックスを申請して、シミュレーション実行に使えます。このサービスは、チームが自分で作ったものをテストし、自分たちに本当に属するアカウントを運用するためのものです。Careemの利用規約を守り、1人の個人または1つの事業につき1アカウントを守ってください。また、利用規定(Acceptable Use Policy)が適用されます。Careemは各権利者の商標であり、OTP Routeとは提携関係にありません。

よくある質問

OTP RouteでCareemに使うサービスIDは何ですか?

サービスIDは careem です。国IDと組み合わせて指定します。例:{"service": "careem", "country": "sa"}。

湾岸地域のSIMカードなしでCareemのOTPを受信できますか?

はい。OTP Gatewayで必要な国の番号を注文し、ダッシュボードまたはAPIでコードを読み取ってください。

Careemは仮想番号を受け付けますか?

常に受け付けるわけではありません。判断はCareem側が行うため、SMSが届かなかったアクティベーションは自動的に返金されます。

Careem向けの仮想番号はいくらですか?

$0.20/コードからです。正確な価格は国によって異なり、注文前に GET /api/v1/prices で取得できます。

Careem SMS認証のテストでは、ポーリングとWebhookのどちらを使うべきですか?

単発の手動実行ならポーリングで十分です。並列のCIジョブでは、冪等なハンドラーを備えた署名付きWebhookのほうが拡張性に優れています。

今後のログインのために、同じCareemの電話番号を保持できますか?

専用番号でのみ可能で、これは米国とカナダ向けの製品です。OTP Gatewayの番号は1回分の認証コードのみを扱います。

OTP Routeで複数のCareemライダーアカウントを作成できますか?

いいえ。自社のテストと正当な事業アカウントにのみ使用し、Careemの利用規約に従って、1人の個人または1つの事業につき1アカウントにしてください。

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