邮箱设置

API 0.16.0OpenAPIllms-full.txt

邮件模板

每个邮箱最多 100 个模板。字段为 name、subject、text 和 html；HTML 会经过清理。模板本身不会发送邮件。

模板将替换编辑器中的正文，收件人和附件将保留。

POST /v1/mailboxes/42/templates
Content-Type: application/json

{"name":"Welcome","subject":"Welcome","text":"Thank you for joining us.","html":"<p>Thank you for joining us.</p>"}

自动回复

关闭浏览器后仍会自动回复，并计入发送限额。不回复邮件列表及自动邮件。

自动回复的日期必须包含时区；repeat_days 范围为 1–30。仅回复新收到的私人邮件：From 必须与 Return-Path 一致。

PUT /v1/mailboxes/42/autoresponder
Content-Type: application/json

{"enabled":true,"subject":"Away","text":"I will reply when I return.","starts_at":null,"ends_at":null,"repeat_days":7}

过滤器

每个邮箱最多 100 个过滤器，每个过滤器最多 20 个条件。条件比较完整邮件头；ASCII 不区分大小写，其他字符区分大小写。

使用第一个匹配的过滤器，发件人规则优先。处理已有邮件需单独启动。

修改过滤器返回 operation。应用于历史邮件需要 8–120 个字符的 Idempotency-Key。重试时使用同一个键，通过 GET /v1/operations/{operation_id} 查询状态。

将处理收件箱和自定义文件夹，不包括已发送、草稿、垃圾邮件和已删除邮件。

POST /v1/mailboxes/42/filters
Content-Type: application/json

{"name":"Invoices","enabled":true,"match":"all","conditions":[{"field":"subject","operator":"contains","value":"Invoice"}],"mark_read":false,"important":true,"trash":false,"move_to":null}

POST /v1/mailboxes/42/filters/17/apply
Idempotency-Key: apply-filter-0001

预览

file_infected

发现威胁，已阻止打开此文件。

file_scan_unavailable

杀毒服务暂时不可用，请稍后重试。

对于 DOC、XLS、XLSX、PPT、PPTX 和 ODT，在文件或附件内容请求中添加 preview=pdf。每个邮箱每分钟最多转换 10 次。

X-File-Scan: clean 和 X-File-Scanned-At 表示扫描结果与时间。文件列表中的 scanned_at 可以为 null。结果缓存一小时；检测到威胁或扫描服务不可用时，不会返回文件。

GET /v1/mailboxes/42/files/<file_id>/content?preview=pdf

X-File-Scan: clean
X-File-Scanned-At: 2026-10-22T12:00:00Z