Vinted 激活的 API 调用顺序是怎样的？
Vinted 验证码 API 流程与其他所有服务使用相同的 OTP Gateway 接口，地址为 https://otproute.com/api/v1，并使用以 or_live_ 为前缀的 Bearer 密钥：
- 用
GET /api/v1/services确认服务 id；Vinted 的服务 id 是vinted。通过GET /api/v1/countries获取国家 id。 - 调用
GET /api/v1/prices?country=<id>&service=vinted，查看实时价格以及该组合是否有可用号码。 - 用
POST /api/v1/activations下单，请求体类似{"service": "vinted", "country": "fr"}。保存激活 id 和返回的号码。 - 把号码输入测试账号的 Vinted 手机号步骤，然后等待验证码。
- 如果该场景被放弃，
POST /api/v1/activations/{id}/cancel会立即退回资金。
密钥在开发者控制台创建，每个账号最多 10 个，API 每分钟接受 300 次请求。GET /api/v1/balance 是 CI 任务一个成本很低的预检调用。开发者页面汇集了全部参考资料。
Webhook 处理程序应该如何处理 Vinted 验证码？
让一个端点（每个账号允许五个）订阅 activation.sms_received，同时订阅 activation.expired 和 activation.cancelled，这样等待中的任务可以干净地退出。每次投递都带有 X-OTPRoute-Signature: t=<unix>,v1=<hex>。
- 用端点密钥对
<t>.<raw body>计算 HMAC-SHA256，并以恒定时间方式与v1比较。 - 丢弃时间戳过旧的请求，以防止重放。
- 以激活 id 为键写入每个事件，这样同一事件的第二次投递不会改变任何东西。
- 先返回 2xx，再把耗时的工作交给队列。
对于单个测试，轮询是更简单的替代方式：每隔几秒调用一次 GET /api/v1/activations/{id}，直到验证码出现或激活结束。我们关于用 HMAC 保护 OTP Webhook的指南详细展示了签名校验。
Vinted 什么时候要求提供手机号？
Vinted 是一个二手服饰及其他闲置物品的交易平台，以各国独立站点的形式运营，主要分布在欧洲。与许多交易平台一样，它可能要求会员添加并确认 Vinted 手机号，例如在账号设置时、登录来自陌生设备时，或在修改敏感账号信息之前。具体提示因市场而异且会随时间变化，所以请把任何测试计划当作在 Vinted 更新应用后需要重新核对的内容。
对于围绕 Vinted 开发的团队，例如卖家工具、管理品牌自有店铺的代理商，或检查集成的 QA 工程师，用于测试的 Vinted 短信验证，说白了就是把那一条验证码送到你掌控的号码上。
Vinted 号码可以选择哪些国家？
Vinted 号码在 198 个国家列出。欧洲的选项包括法国、德国、英国、西班牙、意大利、波兰、立陶宛、荷兰、比利时、捷克、葡萄牙、奥地利、瑞典、爱尔兰和罗马尼亚，而 GET /api/v1/countries 中的完整列表远不止欧洲。
在交易平台上，号码所属国家的分量比在即时通讯应用上更重。请选择与你正在测试的账号同一市场的号码，因为 Vinted 的个人资料属于某一个国家站点，来自别处的号码可能被拒绝，或者在用户看来就是不对劲。我们关于 OTP 国家路由的文章解释了如何把测试用例对应到线路上。
我可以改用控制台接收 Vinted OTP 吗？
可以。登录，为钱包充值，打开 OTP Gateway，选择 Vinted 和账号所属国家。价格会在你确认之前显示。把号码复制到 Vinted，验证码一到达就会出现在激活页面上。这和 API 调用创建的是同一种订单，所以手动检查与自动化检查的结果具有可比性。
Vinted 验证码为什么可能没收到？
每个激活开放 20 分钟。如果在这段时间内没有收到短信，或者你取消了订单，全额款项会自动退回你的钱包。
收不到验证码的常见原因：
- 虚拟号码被拒绝。 和许多平台一样，Vinted 可能在手机验证时拒绝虚拟号码。没有任何线路能改变这一点，这正是设置退款的原因。
- 送达较慢。 时间取决于线路，所以放弃之前请让窗口走完。
- 号码库存紧张。 稍后重试，或者换一个仍符合你测试的国家。
- 重试风暴。 连续快速重新下单很少有用；请退避，并记录每个激活 id。
做 Vinted 相关工作时，长期号码会是更好的选择吗？
一次性号码只处理一条验证码。如果测试账号之后必须再次登录，或运营团队需要在稳定的线路上接收账号提醒，专属号码是更好的工具，但它只在美国和加拿大销售，$1.95/月起，入站短信显示在控制台，并通过 number.sms_received Webhook 转发。由于大多数 Vinted 市场在欧洲，只有当美国或加拿大号码确实适合该账号时，这才有帮助。临时号码与专属号码的对比讲解了其中的取舍。
我们如何负责任地使用 Vinted 号码？
请遵守 Vinted 的条款。每个真实的个人或企业只保留一个账号，并且只在确实属于你的账号和产品上使用 Vinted 虚拟号码，例如用于你自己集成的测试账号，或企业自己的店铺。OTP Route 不用于批量创建账号，也不用于绕开平台的决定，每笔订单都适用我们的《可接受使用政策》。Vinted 是其所有者的商标，OTP Route 与其没有关联。
常见问题
OTP Route 为 Vinted 使用什么服务 id？
在 GET /api/v1/prices 和 POST /api/v1/activations 的请求体中使用 vinted。
接收 Vinted OTP 要多少钱？
$0.20 起；具体价格取决于国家，由 API 实时返回，并显示在控制台中。
如果 Vinted 拒绝了号码，我会被收费吗？
不会。如果 20 分钟内没有验证码到达，或者你取消了订单，全额款项会退回你的钱包。
我的 Vinted 测试号码应该来自哪个国家？
与你正在测试的账号所属的国家站点一致，这样号码才符合个人资料所属的市场。
我能在不动用钱包资金的情况下测试 Vinted 集成吗？
可以。在开发账号上申请沙盒模式，API 就会返回模拟号码和验证码，让你端到端地运行整个流程。
我可以用加密货币为 Vinted 验证号码付款吗？
预付美元钱包支持银行卡付款以及 USDT/USDC 稳定币，每次充值都会通过邮件发送 PDF 发票，且没有月费。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。