邮箱到期时间 API
为邮箱设置或清除用户自定义到期时间。到期的邮箱立即失效(凭据与已删除邮箱一样被拒绝,新邮件将被拒收),剩余数据会在自动清理时删除,不可恢复。
该接口需要邮箱地址凭据(JWT)。
bash
POST /api/expire请求头:
Authorization: Bearer <address_jwt>
请求体(JSON):
| 字段 | 类型 | 说明 |
|---|---|---|
expire_at | number | 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拒收。