Skip to content

邮箱到期时间 API ​

为邮箱设置或清除用户自定义到期时间。到期的邮箱立即失效(凭据与已删除邮箱一样被拒绝,新邮件将被拒收),剩余数据会在自动清理时删除,不可恢复。

该接口需要邮箱地址凭据(JWT)。

bash
POST /api/expire

请求头:

  • Authorization: Bearer <address_jwt>

请求体(JSON):

字段类型说明
expire_atnumber | null邮箱到期的 Unix 时间戳(秒)。必须在当前时间 1 分钟至 30 天之内。null 表示清除到期时间。

示例:

bash
# 10 分钟后到期
curl -X POST https://example.com/api/expire \
  -H "Authorization: Bearer <address_jwt>" \
  -H "Content-Type: application/json" \
  -d "{\"expire_at\": $(( $(date +%s) + 600 ))}"
json
{ "expire_at": 1795415039 }

清除到期时间:

bash
curl -X POST https://example.com/api/expire \
  -H "Authorization: Bearer <address_jwt>" \
  -H "Content-Type: application/json" \
  -d "{\"expire_at\": null}"
json
{ "success": true, "expire_at": null }

说明:

  • 当前的到期时间包含在 /api/settings 返回的 expire_at 字段中(未设置时为 null)。
  • 绑定了用户账户的地址不能设置到期时间,请求会被拒绝。
  • 定时清理会在任何管理员自动清理设置之前移除已到期地址及其全部数据(邮件、发件设置、绑定等)。
  • 发送到已到期地址的新邮件将以 Mailbox expired 拒收。

文档改编自 MIT 许可的 cloudflare_temp_email 项目 — 许可与致谢