收信
入站邮件
创建收件箱、接收路由过来的邮件、留存附件,并按时间顺序构建会话。
创建地址
使用有效的本地部分(local part),在工作区内的某个域名上创建收件箱。收件箱可以处于启用或停用状态。停用后将不再路由新邮件,但不会删除已保留的邮件。
路由
Cloudflare Email Routing 会将原始邮件传递给 SendHQ。Worker 在全局范围内解析收件人域名,匹配一个处于启用状态的收件箱,解析安全的 MIME 内容,存储私有附件,并将该邮件记录为入站邮件。
会话归并
入站和出站邮件通过 Message-ID、In-Reply-To 和 References 关联在一起。会话端点按时间顺序返回租户范围内的邮件。
已读状态与搜索
使用 PATCH /emails/:id 并传入 {"read": true};或传入 {"archived": true},将收到的邮件从收件箱视图中移除而不删除它。邮件列表支持按方向、状态、域名、收件箱、标签、是否归档、发件人、收件人、是否未读和日期进行筛选。query 会搜索主题、正文、地址和附件文件名。domain 和 label 接受逗号分隔的列表。
转发
使用 PUT /inboxes/:id/forwarding 并传入 {"forward_to": "team@example.net"},即可将该地址收到的每封邮件都抄送一份到另一个邮箱。账户所有者自己的邮箱会立即生效。其他任何地址都会收到一封从该收件箱的已验证域名发出的确认邮件,在对方确认之前,转发一直处于 pending 状态。转发的副本从收件箱地址发出,并将原始发件人设为 Reply-To;每份副本计为一个收件人,会跳过被抑制的目标地址,并且永远不会被再次转发。发送 {"forward_to": null} 即可关闭转发。
保留期限
邮件和附件会按照工作区的保留配置进行保留。附件的存储对象过期后,其元数据仍可能可见,并带有 available: false。