自有域 MX · Key 鉴权 · 只收不发

临时验证码邮箱 API
干净、可配额、可回查

用业务 API Key 创建邮箱 → SMTP 收信 → HTTP 拉验证码。面向注册/验证自动化, 不主打永久邮箱托管;邮件与邮箱会按 TTL 定期清理。 公开页已关闭免 Key 白嫖查信。

X-API-Key 鉴权 Owner 隔离 自动提取验证码 TTL / GC VWH 兼容协议
3 档
Trial / Lite / Bulk 套餐,商城即时发卡
Owner
仅创建该邮箱的 Key 可查信,防蹭号
~72h
默认邮件保留(可配置),到期 GC
~7d
默认邮箱保留(可配置),非永久托管

销售计划

不懂对接 / 不会用 API 请勿拍 · 虚拟商品不支持退换货

试用
Trial
¥9.9
  • 联调 / 小量验证
  • 较低日配额 · 限速适中
  • 适合先跑通流程
购买 Trial
批量
Bulk
¥99
  • 大批量创建 + 轮询
  • 更高日配额与 RPM
  • 偏一次性使用,少回查
购买 Bulk

价格以商城实时标价为准。购买后获得一行 mk_... 业务 Key;到 /app 查信台 粘贴即可使用。批量补货也可联系运营。

5 分钟接入

必须先创建邮箱再查信 · 非 owner 返回 404

1

购买并保存 API Key

商城发卡得到 mk_...,本地保存。不要发到公开群 / Git。

2

创建邮箱(绑定到你的 Key)

POST /api/v1/mailboxes 随机生成,或指定 email / domain

3

在目标站点用该邮箱注册

等待验证码邮件到达本服务(只收不发)。

4

拉信 / 提取验证码

GET /api/v1/mailboxes/{email}/messages 或单封 /code。也可在查信台操作。

5

额度与清理

受 RPM / 日建箱配额限制。邮件约 72h、邮箱约 7 天清理(可配置),勿当长期邮箱。

快速示例 · cURL
export KEY='mk_你的业务Key'
export BASE='https://mail-api.ai-key.top'

# 1) 验证 Key
curl -sS -H "X-API-Key: $KEY" "$BASE/api/v1/me" | jq

# 2) 创建随机邮箱
EMAIL=$(curl -sS -X POST -H "X-API-Key: $KEY" -H 'Content-Type: application/json' \
  -d '{}' "$BASE/api/v1/mailboxes" | jq -r '.result.email')
echo "email=$EMAIL"

# 3) 查信(轮询)
curl -sS -H "X-API-Key: $KEY" \
  "$BASE/api/v1/mailboxes/$(python3 -c "import urllib.parse,os;print(urllib.parse.quote(os.environ['EMAIL'],safe=''))")/messages?limit=10" | jq

# 4) 列自己的邮箱
curl -sS -H "X-API-Key: $KEY" "$BASE/api/v1/mailboxes?limit=50" | jq

API 参考

Base: https://mail-api.ai-key.top · Header: X-API-Key: mk_...

接口说明要点
GET/api/v1/me 校验 Key,返回名称/配额用量/可用域名 接入第一步
POST/api/v1/mailboxes 创建并绑定邮箱到当前 Key Body 可选 {"domain":"..."}{"email":"..."}
GET/api/v1/mailboxes 列出本 Key 拥有的邮箱 ?limit=&offset=
GET/api/v1/mailboxes/{email}/messages 拉该邮箱最近邮件 必须是本 Key 创建的邮箱
GET/api/v1/messages/{id} 单封邮件详情 含 subject / from / text / html
GET/api/v1/messages/{id}/code 从邮件提取验证码 返回 {"code": "..."} 或 null
DEL/api/v1/mailboxes/{email} 删除自己的邮箱 ?purge=1 可顺带清邮件

统一响应:{"success": true, "result": ...}{"success": false, "error": {"code":"...","message":"..."}}。 CPA / 旧客户端可走 VWH 兼容路由(与历史协议一致)。健康检查: /health

规则与限制

用之前请读完 · 避免误购

适合

  • 自动化测试 / 批量注册验证码接收
  • 有开发能力,会调 HTTP API
  • 能接受临时邮箱与定期清理

不适合

  • 不会对接 API、只想网页永久邮箱
  • 重要长期账户(银行/主号等)
  • 需要主动发信 / SMTP 出站
  • 免 Key 公开查别人邮箱(已关闭)

常见问题

买前先看 · 减少无效沟通

买完 Key 怎么用?

打开 /app 查信台 粘贴 mk_... → 点「保存并验证」→「随机新建」→ 复制邮箱去注册 → 回来查信或开自动刷新。

能免 Key 公开查邮箱吗?

不能。公开白嫖查信已关闭,只有创建该邮箱的业务 Key(owner)才能拉信,防止蹭号。

邮件能长期保存吗?

不主打永久托管。默认邮件约 72 小时、邮箱约 7 天清理(可配置)。大批量场景通常一次性使用,少回查。

不会 API 可以买吗?

不懂对接 / 不会用请勿拍。 虚拟商品不支持退换货。查信台提供网页操作,但配额、错误码与自动化仍建议会基础 HTTP。