FastPVA API 接入：把手工取号变成稳定流程

FastPVA API 接入：把手工取号变成稳定流程

如果你的团队每天都在重复同样的接码动作，那么 API 的价值就在于把人工操作改成可重复执行的系统流程。

标准流程

通常可以按下面的顺序走：

1. 先拉取项目列表
2. 再选择国家和渠道
3. 发起取号
4. 持续轮询验证码
5. 流程结束后释放订单

先从项目列表开始

先用项目列表接口获取完整数据，分页参数保持明确，这样后续接入会更稳定。

const params = new URLSearchParams({ page: "1", limit: "20", keyword: "telegram", token: TOKEN });
const res = await fetch(`${BASE_URL}/v4/projects?${params}`);

发起取号

拿到项目返回的 pid、channelId 和 locale 后，再调用取号接口。如果返回异步状态，不要立刻判失败，应该继续轮询。

const params = new URLSearchParams({ pid: "100001", channelId: "1", locale: "US", token: TOKEN });
const res = await fetch(`${BASE_URL}/v4/getNumber?${params}`);

查询验证码

记住上一步返回的订单 ID。多个订单一起查的时候，可以用下划线拼接后再请求取码接口。

释放订单

验证码处理完成，或者当前流程不再需要这个号码时，及时释放订单。这样可以让控制台更干净，也更方便后续排查重试逻辑。

API 的价值不只是快，而是稳定。流程一旦被固化，日志、排错和团队协作都会轻松很多。