接入 API,该从哪一步开始
写给想通过 API 把 SimAggregator 对接进自己系统的技术供应商:开始之前要准备什么,系统里要内置哪些逻辑,又该按什么顺序逐步接入。
开始之前要准备什么
通过 API 对接,首先要有一个已经完成接入、通过审核的供应商账户,这和通过后台操作用的是同一个账户,API 并不提供另一条跳过审核的通道。如果计划里除了激活,还打算卖一天、三天或一周的长租,账户需要再单独开通长租权限:这是账户层面的开关,不是某个接口自带的参数,没开通的话,不管是在后台下单,还是通过 API 发请求创建这类订单,平台都会拒绝,没有办法靠走 API 绕开这道限制。
接下来要决定的是,先把哪一块数据接进自己的系统:号码状态、订单、价格,还是入账记录。这几块分别对应自己系统里不同的部分:状态对应监控,订单和入账对应财务台账,价格对应定价逻辑,一次性全部接入,出问题时也更难判断是哪一步出的错。设备和服务越多,自动化带来的省力就越明显,SimAggregator 的目录本身就收录了 3000 多个服务;但真正动手接入的时候,从一块数据、一个场景开始走通,再逐步往外扩展,会更稳妥。
需要内置哪些逻辑
平台把订单分成两类:激活,针对单个服务,时长在 20 到 60 分钟之间,具体取决于服务本身;长租,按一天、三天或一周计,可以只接某个服务的短信,也可以整号出租,收下这个号码在租期内收到的所有短信。两者的退款规则不一样:激活如果验证码没送到,钱会退给买家;长租从一天起算,超过第一个小时之后,一般就不再支持退款。这个差别最好直接写进收入统计的逻辑里:激活入账之后,还有一小段时间可能被回退,统计时要留出这个窗口;长租则在开始后一小时左右基本就定型了,这之后账上的这笔钱基本不会再变动。
号码并不是随时都能卖:它可能正被一笔整号出租占着,也可能刚结束一笔整租,还卡在后面的窗口期里,还可能是刚接入不久、只能整号出租的新 SIM 卡。这几种状态都是订单和平台规则决定的,不是设备故障:只看设备在不在线、信号好不好,很容易漏掉这几种情况,把一个当下卖不了的号码错误标成可售,或者反过来,把正常的等待状态误判成设备异常去报警。号码到期后被再次买走,算的是一笔全新订单,不会接着上一笔续期。如果交给自动化来决定什么时候把号码重新挂出去,就要把这几种订单状态和设备本身的状态放在一起判断,少看一类都不够。
按什么顺序逐步接入
比较稳妥的顺序,是先把能看、不会改动结果的数据接进来:设备和号码状态、订单历史、入账记录,再去碰会改变结果的动作,比如在平台划定的价格区间内调价。先接只读数据的好处是,就算自己这边的解析逻辑有问题,也不会对线上产生实际影响,可以先对照后台核实数据对不对,确认没问题了,再决定要不要把动作也交给自动化。入账和提现是两件事:入账在买家付款后立刻发生,提现则要供应商自己另外提交一次申请才会处理,这两步最好在自己的账务记录里分开标注,不要并成同一个事件,否则容易把已经确认的收入和已经到手的钱混在一起。
循序渐进能把风险控制住:可以先挑一小部分号码交给自动化验证一轮,剩下的仍然通过后台手动处理,两边用的是同一个账户、同一批数据,互不冲突。等验证过的那部分跑稳了,再逐步把更多号码交出去,后台始终可以接回来兜底,不是非此即彼、一次性切换的事。