📱 SMS 收码网关

v1.0.0
连接中...
总短信
–
未读
–
今日
–
验证码
–
设备
–
短信列表
验证码
设备
API 文档
接入指南
已选 0 条
接收号码发件人短信内容验证码时间操作
加载中…
点击验证码即复制 · 程序调用见 API 文档 的 /api/code
验证码接收号码发件人时间状态操作
加载中…
设备在第一次上报短信时会自动注册,无需手动添加
加载中…

API 文档

Base URL: OpenAPI 规范:/openapi.json(可导入 Postman / Apifox) 完整文档见随附 API.md

接入指南

任何能发 HTTP 请求的设备都能接入。只需把三个字段 phone(本机号码)、sender(发件人)、body(内容)发到网关即可,无需 Key。

🍎 iPhone 快捷指令

iOS 17 及以上系统限制:「信息」触发的自动化无法完全静默运行,每条短信到达时会弹出一条通知,需要点一下通知才会执行转发。iOS 16 及以下可全自动。这是苹果系统限制,任何 App 都绕不过。
1
打开「快捷指令」App → 底部「自动化」→ 右上角「+」→ 向下找到「信息」
2
「发件人」留空(即任何人)、「信息包含」留空 → 选「立即运行」→ 下一步
3
「新建空白自动化」→ 添加操作「获取 URL 内容」,按下面配置:
URL:      /api/sms
方法:     POST
请求体:   JSON
  phone   → 文本:本机手机号(如 13800138001)
  sender  → 变量「快捷指令输入」→ 选「发件人」
  body    → 变量「快捷指令输入」→ 选「内容」
4
完成。10 台手机各配一次,phone 填各自的号码。手机和服务器需在同一网络,或服务器有公网地址。
5
测试:给这台手机发一条短信,看本页面是否实时出现。

🤖 安卓 SmsForwarder(开源,可全自动)

安装 SmsForwarder → 发送通道 → 新增「Webhook」:

请求方式: POST
Webhook: /api/sms
消息模板(JSON):
{"phone":"13800138001","sender":"[from]","body":"[content]"}

然后新增转发规则:短信 → 全部 → 选上面的通道。phone 填该手机的号码。

🔌 硬件模块 / 嵌入式(ESP32、Air724、树莓派等)

只能发 GET 的设备用 /api/push(参数 URL 编码):

GET /api/push?phone=13800138001&sender=10086&body=%E9%AA%8C%E8%AF%81%E7%A0%81123456

🐍 程序取验证码(Python 示例)

import urllib.request, json, time

BASE = ""
t0 = int(time.time())
# ... 在这里触发你的业务发送验证码 ...
url = BASE + "/yzm/api/code?phone=13800138001&since=" + str(t0) + "&wait=60"
with urllib.request.urlopen(url, timeout=70) as r:
    print(json.load(r)["code"])   # 123456

更多语言示例见随附 examples/ 目录(python_client.py / node_client.js / curl.sh)。

📡 程序被动接收(Webhook)

服务端启动时加 -webhook https://你的程序/hook,每条新短信会 POST 到你的地址,可选 -webhook-secret 做 HMAC-SHA256 签名校验,详见 API.md。