邮件
AM 支持你使用自有域名发送邮件，并通过 DKIM 签名提升送达率。
模板、投递追踪和退信处理均为内建能力。
发送邮件
直接发送
POST /api/accounts/:account_id/email-messages/send使用显式内容发送：
- From/To/CC/BCC 联系人
- 主题与正文（文本 + HTML）
模板发送
POST /api/accounts/:account_id/email-messages/send-template通过模板与变量替换发送（{{name}} → “Jane”）。
邮件身份
邮件身份是账户允许使用的发件人地址。
| 操作 | Endpoint |
|---|---|
| 创建 | POST /api/accounts/:account_id/email-identities |
| 列表 | GET /api/accounts/:account_id/email-identities |
| 更新 | PATCH /api/email-identities/:email_identity_id |
| 删除 | DELETE /api/email-identities/:email_identity_id |
域名与 DKIM
设置流程
- 注册域名：
POST /api/accounts/:account_id/domains - 执行检查：
POST /api/domains/:domain_id/checks - 创建 DKIM 密钥：
POST /api/domains/:domain_id/dkim-keys - 激活 DKIM 密钥：
PATCH /api/dkim-keys/:dkim_key_id
DNS 记录
| Record | Name | 用途 |
|---|---|---|
| TXT | _acme.mail.example.com | 域名所有权 |
| TXT | selector._domainkey.mail.example.com | DKIM 公钥 |
域名检查
AM 会验证：
- TXT 所有权记录
- CNAME 配置
- A 记录
- TLS 证书
- SPF、DKIM、DMARC、BIMI
- MX 记录
邮件模板
使用变量创建可复用模板：
Subject: Welcome, {{name}}!
Hi {{name}},
Your account {{account_name}} is ready.| 操作 | Endpoint |
|---|---|
| 创建 | POST /api/accounts/:account_id/email-templates |
| 列表 | GET /api/accounts/:account_id/email-templates |
| 获取 | GET /api/email-templates/:email_template_id |
| 更新 | PATCH /api/email-templates/:email_template_id |
| 删除 | DELETE /api/email-templates/:email_template_id |
投递追踪
事件用于追踪邮件生命周期。event_type 取决于邮件服务商，常见值包括：
| Event | 说明 |
|---|---|
queued | 已接受，等待投递 |
sent | 已交付给接收方 MTA |
bounced | 永久投递失败 |
消息与事件 API
| 操作 | Endpoint |
|---|---|
| 列出消息 | GET /api/accounts/:account_id/email-messages |
| 搜索消息 | POST /api/accounts/:account_id/email-messages/search |
| 按搜索删除消息 | POST /api/accounts/:account_id/email-messages/search-delete |
| 获取消息 | GET /api/email-messages/:email_message_id |
| 列出事件 | GET /api/accounts/:account_id/email-message-events |
| 搜索事件 | POST /api/accounts/:account_id/email-message-events/search |
| 按搜索删除事件 | POST /api/accounts/:account_id/email-message-events/search-delete |
退信处理
硬退信会自动创建邮箱封禁记录，用于保护发件人信誉。
| 操作 | Endpoint |
|---|---|
| 列出封禁 | GET /api/accounts/:account_id/email-address-bans |
| 创建封禁 | POST /api/accounts/:account_id/email-address-bans |
| 删除封禁 | DELETE /api/accounts/:account_id/email-address-bans/:email_address_ban_id |
相关
- Domain - 域名配置
- DKIM Key - 签名密钥
- Email Identity - 已批准发件人
- Email Message - 邮件消息记录
- Email Template - 模板资源