CASA MAIL API / V1

API
注册接口

请求统一使用 X-API-Key 请求头。响应格式为 JSON，邮箱域支持主域与 mail. 子域。

QUICK START

创建第一个邮箱

curl -X POST https://yazkejifuwu.casa/api/inboxes \
  -H "X-API-Key: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"prefix":"nova4821","domain":"yazkejifuwu.casa"}'

POST/api/inboxes

创建或登记邮箱

{ "prefix": "nova4821", "domain": "yazkejifuwu.casa" }

GET/api/inboxes

列出邮箱库

返回最近创建的 100 个邮箱。

GET/api/inboxes/{address}/messages

读取邮箱邮件

返回主题、发件人、正文、验证码与收件时间。

GET/api/messages/{id}

读取单封邮件

按邮件 ID 获取完整内容。

RESPONSE

邮件返回示例

{
  "address": "nova4821@yazkejifuwu.casa",
  "messages": [
    {
      "id": "msg_...",
      "sender": "OpenAI <noreply@openai.com>",
      "subject": "Verify your email address",
      "verificationCode": "483921",
      "receivedAt": "2026-08-24T00:00:00.000Z"
    }
  ]
}