用业务 API Key 创建邮箱 → SMTP 收信 → HTTP 拉验证码。面向注册/验证自动化, 不主打永久邮箱托管;邮件与邮箱会按 TTL 定期清理。 公开页已关闭免 Key 白嫖查信。
不懂对接 / 不会用 API 请勿拍 · 虚拟商品不支持退换货
价格以商城实时标价为准。购买后获得一行 mk_... 业务 Key;到
/app 查信台 粘贴即可使用。批量补货也可联系运营。
必须先创建邮箱再查信 · 非 owner 返回 404
商城发卡得到 mk_...,本地保存。不要发到公开群 / Git。
POST /api/v1/mailboxes 随机生成,或指定 email / domain。
等待验证码邮件到达本服务(只收不发)。
GET /api/v1/mailboxes/{email}/messages 或单封 /code。也可在查信台操作。
受 RPM / 日建箱配额限制。邮件约 72h、邮箱约 7 天清理(可配置),勿当长期邮箱。
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
import requests, time
BASE = "https://mail-api.ai-key.top"
KEY = "mk_你的业务Key"
H = {"X-API-Key": KEY, "Content-Type": "application/json"}
me = requests.get(f"{BASE}/api/v1/me", headers=H, timeout=20).json()
print(me)
r = requests.post(f"{BASE}/api/v1/mailboxes", headers=H, json={}, timeout=20).json()
email = r["result"]["email"]
print("email =", email)
# 在目标站注册后轮询
for _ in range(30):
msgs = requests.get(
f"{BASE}/api/v1/mailboxes/{email}/messages",
headers=H, params={"limit": 10}, timeout=20,
).json()
rows = msgs.get("result") or []
if rows:
print(rows[0])
break
time.sleep(3)
const BASE = "https://mail-api.ai-key.top";
const KEY = "mk_你的业务Key";
const headers = { "X-API-Key": KEY, "Content-Type": "application/json" };
const me = await fetch(`${BASE}/api/v1/me`, { headers }).then(r => r.json());
console.log(me);
const created = await fetch(`${BASE}/api/v1/mailboxes`, {
method: "POST", headers, body: JSON.stringify({})
}).then(r => r.json());
const email = created.result.email;
console.log("email", email);
// 轮询邮件
for (let i = 0; i < 30; i++) {
const res = await fetch(
`${BASE}/api/v1/mailboxes/${encodeURIComponent(email)}/messages?limit=10`,
{ headers }
).then(r => r.json());
if ((res.result || []).length) {
console.log(res.result[0]);
break;
}
await new Promise(r => setTimeout(r, 3000));
}
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。
用之前请读完 · 避免误购
买前先看 · 减少无效沟通
打开 /app 查信台 粘贴 mk_... → 点「保存并验证」→「随机新建」→ 复制邮箱去注册 → 回来查信或开自动刷新。
不能。公开白嫖查信已关闭,只有创建该邮箱的业务 Key(owner)才能拉信,防止蹭号。
不主打永久托管。默认邮件约 72 小时、邮箱约 7 天清理(可配置)。大批量场景通常一次性使用,少回查。
不懂对接 / 不会用请勿拍。 虚拟商品不支持退换货。查信台提供网页操作,但配额、错误码与自动化仍建议会基础 HTTP。