面向开发者的短信验证 API：入门指南

如果你正在测试应用的注册流程或自动化验证步骤，API 可以让你无需打开控制面板即可完成面板中的所有操作。

开始之前

在控制面板的 API 页面获取你的密钥。不要将密钥提交到代码仓库中，而应将其保存在环境变量里。

基本流程

1. 获取服务和国家列表。
2. 购买号码。
3. 定时轮询状态，或使用 webhook。
4. 验证码到达后完成激活；如果没有到达，则取消。

需要注意的事项

• 重试时，请发送 Idempotency-Key 请求头。如果在网络错误后使用同一个密钥重试，就不会重复购买第二个号码。
• 遵守速率限制： 不要无故缩短轮询间隔。
• 在代码中分别处理“余额不足”和“缺货”的响应。

如果你的软件使用 SMS-Activate 兼容协议，无需修改代码即可通过兼容接口进行连接。所有详细信息都在 API 文档中。