临时邮箱-获取邮件

GET 实用工具

获取指定临时邮箱收到的邮件列表，包含发件人、主题、时间和正文内容。需先通过「临时邮箱-生成」接口获取邮箱地址。

GET https://api.tinyaii.cn/v1/tempmail/mails

请求参数

参数名类型必填说明示例
emailstring必填临时邮箱地址abc123xyz@tempmail.cn

返回字段

字段类型说明
emailstring查询的临时邮箱地址
countint收到的邮件总数
mailsarray邮件列表（按时间倒序排列）
mails[].fromstring发件人地址（如：noreply@example.com）
mails[].subjectstring邮件主题
mails[].datestring收到时间（ISO 8601 格式）
mails[].bodystring邮件正文内容（纯文本）

返回示例

{
  "code": 200,
  "message": "success",
  "data": {
    "email": "abc123xyz@tempmail.cn",
    "count": 1,
    "mails": [
      {
        "from": "noreply@service.com",
        "subject": "【XX平台】您的验证码",
        "date": "2026-06-03T19:30:00Z",
        "body": "尊敬的用户，您的验证码是 123456，10分钟内有效，请勿泄露给他人。"
      }
    ]
  }
}

调用示例

curl "https://api.tinyaii.cn/v1/tempmail/mails?email=abc123xyz@tempmail.cn" \
  -H "Authorization: Bearer YOUR_API_KEY"
const res = await fetch("https://api.tinyaii.cn/v1/tempmail/mails?email=abc123xyz@tempmail.cn", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" },
});
console.log(await res.json());
import requests

resp = requests.get(
    "https://api.tinyaii.cn/v1/tempmail/mails",
    params={"email": "abc123xyz@tempmail.cn"},
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=10,
)
print(resp.json())

把 YOUR_API_KEY 换成你的密钥即可直接运行。密钥只保存在你自己的设备上。