全部文章

getNumber、getStatus、setStatus 3/6/8:激活流程里哪些环节会白白花钱

机器人拿到一个号码,30 秒内没看到短信,就发送了 setStatus 8,接着去取下一个号码。服务器没有接受这次取消,但没人去读这个响应。后来第一个号码收到了验证码:订单已经扣费,验证码却一直没用上。下面按步骤拆解通过 API 完成激活的流程,并列出对接程序会为用不上的验证码付费的几种分支。

流程分步说明

  1. getNumber。机器人按服务和国家获取号码,订单金额在余额中冻结,响应里返回激活 id。在机器人把号码填进目标服务之前,先把这个 id 存进持久化存储:一旦进程崩溃,没有 id 就既取消不了订单,也拿不到验证码。
  2. getStatus。机器人轮询状态,等待验证码。等多久由服务目录决定:每个服务的时限不同,目前均为 1 小时。
  3. setStatus 3。需要同一个号码再收一条验证码:第一条不能用,或者目标服务要求再次验证。发送 3 之后,机器人继续用 getStatus 轮询。
  4. setStatus 6。验证码已使用,订单完成。
  5. setStatus 8。取消。验证码到达之前可以取消,但必须在购买满一分钟之后。

如果机器人什么都不做,验证码也没来,时限一到,冻结的金额会自动退回余额。由此得出对接的首要规则:通过 setStatus 8 取消激活,只有在验证码到达之前才能退款。 收到短信即视为服务已提供,这类订单的费用不予退还。所有退款都退到平台内部余额,而不是钱包。

钱会丢在哪里

第一分钟内取消。就是开头那个场景。每次发送 setStatus 8 都要读取响应。如果因为不满一分钟而取消失败,就继续轮询 getStatus,等购买满一分钟后再重新取消。

轮询与取消的竞态。getStatus 返回“等待中”,机器人发送了 8,验证码恰好在两次请求之间到达。这时取消已经不会成功。再调用一次 getStatus,把验证码用掉:反正这单已经扣费了。

注册失败,收到验证码后再取消。目标服务拒绝了账号,开发者发送 8,等着退款。验证码已经送达,说明服务已经提供;而收到短信并不保证能在第三方服务上注册成功。这类订单请用状态 6 关闭,并在报表里和取消订单分开统计。

被丢下的号码。机器人没取消就转向下一个号码,常见原因是所有服务共用同一个超时时间。如果超时比该服务的时限短,验证码可能在机器人已经不等了的时候才到,这单就白付了。超时要按具体服务的时限来设,不再需要的号码要明确发送状态 8 关闭。

用新号码代替状态 3。第一条验证码不能用,机器人就去买了另一个号码。新的 getNumber 是一笔独立订单,会单独冻结金额,而且在目标服务上的注册也得从头再来。应该在同一个号码上用状态 3 请求新的验证码,并确认 getStatus 返回的是新验证码,而不是之前那条。

成功了却没关单。验证码已经填入,却没发送 6。订单会一直开着,直到时限结束,从日志里也分不清哪些号码已经用完、哪些还在等验证码。目标服务一接受验证码,就发送 6。

从其他平台迁移过来。如果机器人只是改了基础 URL 就切到了我们这里,那各个状态分支都是按原平台的规则写的。请检查取消前的一分钟延迟,以及超时是否按我们目录里的时限设置。

轮询、密钥和 softId

API 限制为每个密钥每分钟 600 次请求,也就是所有未完成订单加起来每秒十次。密集地循环调用 getStatus,很快就会触顶。最危险的情况是,程序把限流拒绝误判为“还没有验证码”,于是取消或丢下号码。每个订单的轮询间隔几秒,限流响应要用单独的分支处理:等待,然后重试。

用 API 密钥下单,扣的是你的余额。请为每个机器人或每个环境单独创建一个带名称的密钥:控制台里能看到每个密钥的最后使用日期,哪个密钥多余一看便知,可以把它吊销。

参加合作伙伴计划的软件作者请注意:确认每次 getNumber 都带上了 softId。缺了它,这笔购买就不会关联到你的 software_id,用户每次激活的 5% 分成也不会计入。如果订单发生了退款,对应的分成会被扣回。

今天就该检查的事

打开控制台里的“API 参考”,逐一核对每种状态的处理逻辑,重点是对 8 的响应处理,以及超时是否按服务时限设置。然后在“资金流水”中选定时间段,把退款记录和机器人日志逐条对照:每个被取消或到期仍未收到验证码的订单,金额都应该退回余额。如果日志里显示已取消,而流水中这笔订单只有扣款,就去“订单历史”里找到这个号码,查看机器人是什么时候发送的 8:是在第一分钟内,还是验证码已经到达之后。

一分钟拿到第一个号码

注册一分钟,充值两分钟,验证码 20 秒到达。

购买号码
没有订阅费第一小时内可取消退款