接收短信 API：在你自己的号码上获取验证码

BusySMS 与虚拟号码服务对比

如何选择

如果你只需要一个用于一次性测试的临时号码，之后不会有任何东西依赖它，那么虚拟号码更快，BusySMS 并不合适。如果账户很重要，比如公司的管理员登录、CI 每晚都要登录的测试账户，或客户早已熟知的号码，就用你自己的号码来接收。

BusySMS 也不是绕过他人验证的手段。它读取的是发到你掌控的号码、属于你自己账户的验证码。它无法读取任何其他人的短信，也不是为批量注册账户而设计的。

BusySMS 如何接收短信

1. 1

   在手机上安装接收端

   Android 上使用 Google Play 中的 BusySMS 应用。iPhone 上使用快捷指令自动化，可搭配或不搭配 BusySMS iPhone 应用。

2. 2

   验证号码

   BusySMS 向该号码发送一条验证码，手机再把它回传。这证明 SIM 卡确实持有该号码；在此之前，任何内容都不会被存储或计费。

3. 3

   接收

   只保留看起来像验证码的短信。每条都会标记接收号码、发件人、识别出的服务以及到达时间。

4. 4

   读取

   你的程序调用 REST API，AI 智能体使用 MCP，人则在控制台查看验证码，或让 Chrome 扩展自动填入。

可以用哪些号码接收

• 你自己手机中 SIM 卡上的任何号码：装有 BusySMS 应用、运行 Android 8.0 或更高版本的 Android 手机，或通过快捷指令、运行 iOS 14 或更高版本的 iPhone。
• 双卡手机中的每张 SIM 卡都是一个独立号码，单独验证、单独计费。
• 号码通过一次短信往返来验证，因此你无法添加不在你手上的 SIM 卡的号码。

通过 API 接收验证码

在控制台的 REST API 下创建密钥，并保存在环境变量中。然后等待某个特定号码上的下一条验证码：

# Digits only: the receiving number +44 7700 900123
curl -s -H "Authorization: Bearer $BUSYSMS_API_KEY" \
  "https://busysms.net/api/v1/codes?phone=447700900123&timeoutMs=60000"

const params = new URLSearchParams({ phone: "447700900123", timeoutMs: "60000" });
const res = await fetch(`https://busysms.net/api/v1/codes?${params}`, {
  headers: { Authorization: `Bearer ${process.env.BUSYSMS_API_KEY}` },
});
if (!res.ok) throw new Error(`BusySMS ${res.status}`);

const { code } = await res.json(); // null if nothing new arrived
console.log(code);

import os
import requests

r = requests.get(
    "https://busysms.net/api/v1/codes",
    params={"phone": "447700900123", "timeoutMs": 60000},
    headers={"Authorization": f"Bearer {os.environ['BUSYSMS_API_KEY']}"},
    timeout=75,
)
r.raise_for_status()
print(r.json()["code"])  # None if nothing new arrived

phone 匹配接收号码（只写数字即可），因此账户中有多个号码时，你拿到的是正确号码的验证码。等待最长 90 秒；如果没有新验证码到达，返回 null，而不是旧的验证码。

如果想查看历史而不是等待，可以用 GET /api/v1/devices/:id/messages 列出某台手机最近的短信；捕获的短信最多保留 7 天。所有接口和错误详见 短信网关 API 指南。

会接收什么，不会接收什么

• 设置时由你为每张 Android SIM 卡选择：所有短信，或只接收验证码类短信。其他短信只有你能看到。
• 在 iPhone 上，检查在手机本地完成：不像验证码的短信永远不会离开手机。
• 网关关闭期间不会捕获任何内容。
• 号码必须先通过验证，它收到的内容才会被存储。

常见问题

常见问题解答