テストと運用のワークフローで OLX の電話認証コードを受け取る

OLX はどこで電話番号を求めるのか？

OLX は複数の地域市場で、人々が車、不動産、家電、日用品を売買するオンライン分類広告サイトを運営しています。多くのマーケットプレイスと同様に、アカウント作成時、広告の公開前、ログインの確認時、アカウント回復時などに、携帯番号を求められることがあります。ワンタイムの SMS コードは番号をアカウントに紐づけ、マーケットプレイスがスパム広告を抑える助けになります。

OLX と連携する、出品者向けツールを作る、あるいは事業のために出品を管理するチームにとって、この認証ステップはテスト計画に含める必要があります。複数のクライアントの出品を運用するエージェンシーは、クライアントのアカウントごとに同じステップに直面します。より広い活用例はマーケットプレイス向けソリューションのページで紹介しています。

OLX の電話番号をリクエストする前のチェックリスト

• まず市場を決める。 OLX のサイトは国ごとに分かれているため、番号はテストするサイトとアカウントに合わせます。
• サービス ID olx を確認する。 GET /api/v1/services でサービス ID を、GET /api/v1/countries で国 ID を確認します。
• 最新の価格と提供状況を確認する。 GET /api/v1/prices?country=<id>&service=olx を使います。
• 受け取り方法を決める。 シークレット付きの Webhook エンドポイントにするか、1 分あたり 300 リクエストの上限を守るポーリングにします。
• アカウントの将来を考える。 同じログインを後で再認証する必要がある場合は、始める前に下の長期回線のセクションをお読みください。

OLX のコードを届けられるのはどの国か？

OTP Route では、197 か国で olx のルートを提供しています。ポーランド、ポルトガル、ルーマニア、ブルガリア、ウクライナ、カザフスタンのほか、ウズベキスタン、ブラジル、インド、パキスタン、インドネシア、トルコ、エジプト、南アフリカなどが含まれます。

国の選択は見た目だけの問題ではありません。マーケットプレイスは通常、自社サイトに対して現地の番号を想定しているため、ポーランドのサイトのテストにはポーランドの番号を、ルーマニアの出品者ワークフローにはルーマニアの番号を使います。市場に合わせることで、テストケースが現実的になり、サイトと番号の不一致による拒否を避けられます。

手順：API で OLX の認証コードを取得する

1. アクティベーションを作成します。or_live_ で始まる Bearer キーで、POST /api/v1/activations に {"service": "olx", "country": "<id>"} を送ります。
2. 返ってきた番号を OLX のフォームに入力します。
3. Webhook で activation.sms_received を処理します。X-OTPRoute-Signature は、エンドポイントのシークレットでタイムスタンプ、ドット、生の本文に対する HMAC-SHA256 を再計算して検証し、古いタイムスタンプのリクエストは破棄します。
4. ハンドラーを冪等にします。アクティベーション ID をキーにして、再配信されてもコードが二重に入力されないようにします。
5. Webhook を受信できない場合は、GET /api/v1/activations/{id} を控えめな間隔でポーリングします。
6. テストを中止する場合は、POST /api/v1/activations/{id}/cancel を呼び出して、すぐに資金を解放します。

手順：運用スタッフ向けのダッシュボードでの操作

コードを書くのではなく出品を管理する人は、ブラウザーで完結できます。サインインして資金を追加し、サービスに OLX、続けて国を選んで、番号を OLX にコピーします。SMS はアクティベーションカードに表示されます。各番号で受け取れるコードは 1 件で、注文は 20 分で失効し、何も届かなければ全額返金されます。

OLX の SMS が届かないときのトラブルシューティング

• 20 分のウィンドウが終わるまで待ちます。マーケットプレイスの送信元は、メッセージをキューに溜めることがあります。
• OLX が一部のサイトで仮想番号を拒否することがある点に留意してください。その場合、注文は自動的に返金されます。
• テストケースが別の市場を許す場合にのみ、別の国のルートを試します。そうでなければ、時間をおいて同じ国で再試行します。
• 送信前に、OLX のフォームで選んだ国が番号の国と一致しているか確認します。
• 短い間隔で連続して再注文するのは避け、OLX への試行の間隔をあけます。

さらに多くのパターンは、OTP 配信失敗を減らすの記事にまとめています。

専用番号が適しているのはどんなときか。ルールは？

一時的な番号は 1 件のコードを受け取ると役目を終えるため、1 回のサインアップテストに向いています。来月再びログインする必要がある出品者アカウントには、保持できる回線が必要です。専用番号は米国とカナダでのみ月額 $1.95 から利用でき、更新されている間はご自身の番号のままで、受信 SMS を Webhook に転送します。それ以外の市場にはセルフサービスの長期番号がないため、[email protected] にメールでお問い合わせください。選ぶ際は、一時番号と専用番号の比較が参考になります。

OTP Route は、自社の正当なプロダクトとアカウントにのみご利用ください。アカウントは実在する個人または事業者 1 つにつき 1 つとし、出品は誠実に行い、OLX の規約と当社の利用規約（Acceptable Use Policy）を完全に守ってください。支払いは、カードまたは USDT/USDC でチャージするプリペイド式 USD ウォレットで行い、チャージごとに PDF の請求書が発行されます。

よくある質問

テスト用に OLX の OTP を受信するには？

適切な国で olx サービスの番号を注文し、OLX に入力して、ダッシュボードまたは API でコードを確認します。

すべての国で OLX 用の仮想番号はありますか？

OTP Route は 197 か国で OLX のルートを提供していますが、各組み合わせの提供状況は一日の中で変わります。注文前に GET /api/v1/prices を確認してください。

OLX の電話番号はどの国のものにすべきですか？

作業している OLX のサイトに合わせてください。その市場の現地番号を使うと、テストが現実的になり、拒否も減ります。

テスト用の OLX SMS 認証にはいくらかかりますか？

1 コード $0.20 からで、国によって異なります。コードが届いた場合にのみお支払いいただきます。

同じ番号を、後で OLX にログインするために再利用できますか？

一時的な番号では、1 件のコードしか受け取れないため無理です。米国とカナダでは専用番号が選択肢で、それ以外の国はサポートにお問い合わせください。

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

はい。サポートが開発用アカウントをサンドボックスモードに切り替えられます。その場合、OLX のフローは模擬の番号とコードで動作します。

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

いいえ。OLX はその所有者の商標であり、OTP Route は OLX と提携していません。

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