API で OTP Route の番号から Vinted の SMS コードを取得する

Vinted のアクティベーションの API シーケンスは？

Vinted 認証コード API の流れでは、ほかのすべてのサービスと同じ OTP Gateway のエンドポイントを、https://otproute.com/api/v1 に対して or_live_ で始まる Bearer キーで使用します。

1. GET /api/v1/services でサービス ID を確認します。Vinted の場合は vinted です。国 ID は GET /api/v1/countries から取得します。
2. GET /api/v1/prices?country=<id>&service=vinted を呼び出して、現在の価格と、その組み合わせで番号が利用可能かどうかを確認します。
3. POST /api/v1/activations に {"service": "vinted", "country": "fr"} のような本文を送って注文します。アクティベーション ID と返ってきた番号を保存します。
4. テストアカウントの Vinted の電話番号入力ステップに番号を入力し、コードを待ちます。
5. シナリオを中止する場合は、POST /api/v1/activations/{id}/cancel で資金がすぐに戻ります。

キーは開発者コンソールで作成でき、1 アカウントあたり最大 10 個、API は 1 分あたり 300 リクエストまで受け付けます。GET /api/v1/balance は CI ジョブの事前チェックに手軽な呼び出しです。リファレンス資料は開発者向けページにまとめています。

Webhook ハンドラーは Vinted のコードをどう処理すべきか？

エンドポイント（1 アカウントにつき 5 個まで）で activation.sms_received を購読し、待機中のジョブがきれいに終了できるよう activation.expired と activation.cancelled も購読します。各配信には X-OTPRoute-Signature: t=<unix>,v1=<hex> が含まれます。

• エンドポイントのシークレットで <t>.<raw body> の HMAC-SHA256 を計算し、v1 と定数時間で比較します。
• リプレイを防ぐため、古いタイムスタンプのリクエストは破棄します。
• 同じイベントが 2 回配信されても何も変わらないよう、各イベントをアクティベーション ID をキーにして書き込みます。
• まず 2xx で応答し、時間のかかる処理はキューに渡します。

単発のテストなら、ポーリングのほうが簡単です。コードが表示されるかアクティベーションが終了するまで、数秒おきに GET /api/v1/activations/{id} を呼び出します。署名の検証方法は、HMAC で OTP Webhook を保護するガイドで詳しく説明しています。

Vinted はいつ電話番号を求めるのか？

Vinted は、古着などの中古品を扱うマーケットプレイスで、主にヨーロッパで国ごとの別サイトとして運営されています。多くのマーケットプレイスと同様に、アカウント設定時、見慣れない端末からのログイン時、重要なアカウント情報を変更する前などに、会員に Vinted の電話番号の追加と確認を求めることがあります。具体的なプロンプトは市場によって異なり、時間とともに変わるため、テスト計画は Vinted がアプリを更新したあとに再確認する前提で扱ってください。

Vinted まわりで開発するチーム、たとえば出品者向けツール、ブランドの公式ショップを管理するエージェンシー、連携を確認する QA エンジニアにとって、テスト用の Vinted SMS 認証とは、そのコード 1 件を自分で管理できる番号に届けることにほかなりません。

Vinted の番号にはどの国を選べるか？

Vinted の番号は 198 か国で提供されています。ヨーロッパの選択肢には、フランス、ドイツ、英国、スペイン、イタリア、ポーランド、リトアニア、オランダ、ベルギー、チェコ、ポルトガル、オーストリア、スウェーデン、アイルランド、ルーマニアなどがあり、GET /api/v1/countries の完全なリストはヨーロッパをはるかに超えています。

マーケットプレイスでは、番号の国はメッセージアプリよりも重みを持ちます。Vinted のプロフィールは 1 つの国のサイトに属しているため、テストするアカウントと同じ市場の番号を選んでください。ほかの国の番号は拒否されたり、ユーザーから見て単に不自然に映ったりすることがあります。テストケースをルートに対応づける方法は、OTP の国別ルーティングの記事で説明しています。

代わりにダッシュボードから Vinted の OTP を受信できるか？

はい。サインインしてウォレットにチャージし、OTP Gateway を開いて、Vinted とアカウントの国を選びます。確定する前に価格が表示されます。番号を Vinted にコピーすると、コードが届いた時点でアクティベーションのページに表示されます。これは API 呼び出しが作成するのと同じ注文なので、手動の確認と自動の確認の結果を比較できます。

Vinted のコードが届かないのはなぜか？

各アクティベーションは 20 分間有効です。その間に SMS が届かなかった場合やキャンセルした場合は、全額が自動的にウォレットに戻ります。

コードが届かない主な原因は次のとおりです。

• 仮想番号が拒否される。 Vinted は多くのプラットフォームと同様に、電話認証で仮想番号を拒否することがあります。どのルートでもこれは変えられないため、返金の仕組みがあります。
• 配信が遅い。 タイミングはルートによって異なるため、あきらめる前にウィンドウが終わるまで待ちます。
• 在庫が少ない。 少し時間をおいて、またはテストに合う別の国で再試行します。
• 再試行の連発。 短い間隔で再注文を繰り返してもほとんど効果はありません。間隔をあけ、各アクティベーション ID を記録してください。

Vinted の作業で、長期番号が適していることはあるか？

ワンタイム番号で受け取れるのはコード 1 件分です。テストアカウントが後で再びサインインする必要がある場合や、運用チームが安定した回線でアカウントの通知を受け取りたい場合は専用番号が適していますが、販売対象は米国とカナダのみで、月額 $1.95 からです。受信 SMS はダッシュボードと number.sms_received の Webhook で確認できます。Vinted の市場の大半はヨーロッパなので、米国またはカナダの番号が本当にアカウントに合うときにだけ役立ちます。トレードオフについては、一時番号と専用番号の比較で解説しています。

Vinted の番号を責任を持って使うには？

Vinted の利用規約に従ってください。アカウントは実在する個人または事業者 1 つにつき 1 つとし、Vinted 用の仮想番号は、自社の連携用のテストアカウントや事業者自身のショップなど、本当に自分のものであるアカウントとプロダクトにのみ使用します。OTP Route は、大量のアカウント作成やプラットフォームの判断を回避するためのものではなく、すべての注文に利用規約（Acceptable Use Policy）が適用されます。Vinted はその所有者の商標であり、OTP Route は Vinted と提携していません。

よくある質問

OTP Route では Vinted にどのサービス ID を使いますか？

GET /api/v1/prices と POST /api/v1/activations の本文で、vinted を使います。

Vinted の OTP を受信するにはいくらかかりますか？

1 コード $0.20 からです。正確な価格は国によって異なり、API が最新の値を返し、ダッシュボードにも表示されます。

Vinted が番号を拒否した場合、課金されますか？

いいえ。20 分以内にコードが届かなかった場合やキャンセルした場合は、全額がウォレットに返金されます。

Vinted のテスト用番号はどの国のものにすべきですか？

テストするアカウントの国のサイトに合わせ、プロフィールが属する市場に番号が合うようにします。

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

はい。開発用アカウントでサンドボックスモードを申請すると、API が模擬の番号とコードを返すので、フローをエンドツーエンドで実行できます。

Vinted の認証用番号の支払いに暗号資産は使えますか？

プリペイド式の USD ウォレットは、カード決済と USDT/USDC のステーブルコインに対応しています。チャージごとに PDF の請求書がメールで届き、月額料金はありません。

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