SMS4You 公共 API：用于接收短信、OTP 和虚拟号码的 REST API

2026/7/1

SMS4You 公开 API 正式上线：实现短信接收和号码管理的自动化

我们很高兴宣布推出大家期待已久的 SMS4You 公共 API。现在，您以前在个人账户中手动完成的所有操作，都可以通过程序实现：购买号码、从短信和电子邮件中获取验证码、查看余额和资费。您的脚本、机器人和注册系统可直接与 SMS4You 对接，无需任何手动点击。

下面我们将详细介绍本次发布的内容、其用途以及如何在五分钟内快速上手。

核心功能简介

功能齐全的 REST API，支持 OTP 激活（接收短信）和电子邮件激活。
国家、服务及最新价格目录——控制面板中显示的所有内容，均可通过 API 访问。
Webhooks：验证码和状态变更会自动发送到您的服务器，无需持续查询。
兼容 SMS-Activate 协议：只需更改一个地址，即可迁移现成的集成方案。
基于令牌的简单身份验证，该令牌由您在个人账户中自行生成。
交互式文档，支持直接在浏览器中测试请求。

为什么需要 API

当激活量较少时，手动购买号码是可行的。但一旦涉及数十甚至数百次注册、批量处理，或是将短信接收功能集成到自有产品中，在界面中逐一点击操作就会变得非常不便。 API 正是为了解决这一问题而设计的：您只需在代码中定义一次逻辑，之后一切将自动进行，无论处理量多大，无论何时。

我们开发此API的典型应用场景包括：

在您的软件中自动注册和验证账户；
需要连续处理大量号码的大规模运行和测试；
将短信验证码接收功能直接集成到您的服务或产品中；
将针对其他服务商编写的现有集成迁移至本平台。

API的功能

1. 一站式激活：从购买号码到获取验证码

整个激活生命周期均可通过直观的 REST 端点操作：

选择服务和国家/地区，查看可用性和价格；
通过单次请求购买号码；
接收收到的短信（如果是电子邮件激活，则接收邮件）；
完成、取消或请求重发短信——状态管理完全由您掌控。

支持两大核心产品：接收短信（OTP）和电子邮件激活。每次激活都有一个唯一的标识符，您可通过该标识符在后续操作中进行查询。

2. 最新产品目录与价格

API 提供实时数据：

包含电话区号的国家列表；
服务列表（适用于短信和电子邮件）；
特定服务或国家的价格，以及按页显示的完整价格表。

重要细节：返回的价格已包含您的个人折扣。您在API响应中看到的价格，正是实际从账户余额中扣除的金额。

3. Webhook：验证码自动发送到您手中

为了等待短信而不断查询服务器既浪费资源又效率低下。因此，SMS4You 提供了 Webhook 功能：一旦有新消息到达或激活状态发生变化，我们会自动向您指定的地址发送 HTTP 请求。

您将即时接收事件通知，无需轮询；
每次调用都带有 HMAC 签名，因此您可以确认该请求确实来自我们；
若您的服务器短暂不可用，系统会自动重试；
对于通过白名单限制流量接收的用户，我们会公布发送 Webhook 的 IP 地址列表。

结合 REST API，这便完成了整个集成流程：您自行发送请求，并通过推送通道接收更新。

4. 与 SMS-Activate 的兼容性：无需重写即可迁移

此外，还有一点让我们特别自豪。如果您已有基于 SMS-Activate API 开发的软件，则无需重写集成代码。SMS4You 支持兼容协议：只需将服务器地址更改为我们的，并替换为您的密钥即可。

您现有的代码、库和机器人将照常运行，但将享受 SMS4You 提供的号码、价格和质量服务。这意味着切换到我们的服务只需在配置文件中修改一行代码，而非耗费数周的开发时间。

5. 安全且简单的身份验证

脚本中无需任何用户名和密码。您只需登录个人账户，在**“API令牌”**标签页中创建个人令牌，并在请求中使用该令牌即可。令牌可通过三种方式传递——请选择最适合您库的方式：

请求头 Authorization: Bearer <токен>;
请求头 X-Api-Token: <токен>;
查询参数 ?api_token=<токен>.

您可以创建多个令牌（例如，每个项目一个），并随时撤销已泄露的令牌，而不会影响其余令牌。令牌值仅在创建时显示一次——此后仅由您自行保管。

6. 可动手操作的文档

我们基于 OpenAPI 准备了交互式文档：每个端点都有详细说明，每个字段都标明了类型，而且无需打开终端，即可直接在页面上执行请求。该文档中还设有专门章节，介绍 Webhooks 以及与 SMS-Activate 兼容的协议。

文档可通过 docs.sms4you.org 访问。

五分钟快速入门

API 基础地址： https://api.sms4you.org/api/v1

步骤 1. 查询账户余额和折扣

curl https://api.sms4you.org/api/v1/me \
  -H "Authorization: Bearer YOU TOKEN"

{
  "data": {
    "name": "Ivan",
    "email": "[email protected]",
    "email_verified": true,
    "balance": "12.3456",
    "currency": "USD",
    "discount_percent": 5
  }
}

步骤 2. 查询所需服务的价格

curl "https://api.sms4you.org/api/v1/prices?service_id=SERVICE_ID" \
  -H "Authorization: Bearer YOU TOKEN"

步骤 3. 购买号码

curl -X POST https://api.sms4you.org/api/v1/activations \
  -H "Authorization: Bearer YOU TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"service_id": 123, "country_id": 7, "price": "0.20"}'

回复中将包含手机号码和激活码。

步骤 4. 接收收到的短信

curl https://api.sms4you.org/api/v1/activations/АКТИВАЦИЯ_ID/messages \
  -H "Authorization: Bearer YOU TOKEN"

如果您设置了Webhook，则完全无需执行此步骤——验证码会自动发送到您的账户。

限制与可靠性

为确保服务对所有用户保持稳定，请求频率设有上限（默认每分钟不超过 120 次）。
所有响应（包括错误信息）均采用统一格式：包含易于理解的代码、可读性强的提示信息，以及必要时的详细说明。在代码中处理这些信息非常轻松。
购买时需要账户中已验证的电子邮箱——这是常规的安全措施。

适用对象

开发者，他们需要在自己的产品中集成短信接收功能。
在注册量巨大的套利和营销领域。
负责测试电话验证场景的 QA 团队。
所有已使用与SMS-Activate兼容的软件，并希望找到无需繁琐迁移流程的提供商的用户。

下一步

公开API是我们未来发展的基石。我们的计划是根据您的需求，不断扩展产品覆盖范围和功能。如果您发现缺少某个端点或场景，请通过支持聊天联系我们：我们会阅读每一条反馈，并优先处理真正有需求的内容。

立即体验：

登录个人账户，在“API 令牌”标签页中创建令牌。
访问 docs.sms4you.org 查看文档。
发送第一个请求——其余流程将自动完成。

祝您集成顺利，愿验证码准时送达。