用途
Mailgun Optimize（by Sinch），原名 InboxReady，是一套邮件送达率（deliverability）管理套件。它面向需要监控和诊断邮件发送效果的用户，围绕种子列表收件箱投放测试、IP 与域名黑名单监控、垃圾邮件陷阱追踪、邮件健康评分、DMARC 报表、Google Postmaster Tools 以及 Microsoft SNDS 数据等维度提供查询与配置能力。
主要能力
域名监控：通过 POST /v1/inboxready/domains?domain= 注册域名，是黑名单追踪、DMARC 报表和 Postmaster Tools 的基础；支持列表、验证与删除。域名注册使用查询参数，而非 JSON 请求体。
收件箱投放测试：基于种子列表。先创建种子列表（POST /v4/inbox/seedlists），再创建测试（POST /v4/inbox/tests），请求体包含 html 或 template_name。响应返回 result_id，需轮询 GET /v4/inbox/results/{result_id} 获取结果。
IP 黑名单监控：通过 /v1/inboxready/ip_addresses 和 /v1/inboxready/ip_addresses/{ip} 检查发送 IP 是否被列入黑名单。
域名黑名单监控：通过 /v1/monitoring/domains/{domain}/blocklists 检查域名黑名单状态；通过 /v1/monitoring/domains/{domain}/events 或 /v1/monitoring/domains/events 查看事件。
垃圾邮件陷阱：通过 /v2/spamtraps 识别陷阱命中（pristine、recycled、typo）。注意 /v1/spamtraps 已弃用，应使用 v2。
邮件健康评分：通过 /v1/maverick-score/total 获取总体评分，通过 /v1/maverick-score/grouped 按域名/IP/子账户查看评分。
Google Postmaster Tools：在 /v1/reputationanalytics/gpt/ 下提供 Gmail 相关指标（垃圾邮件率、域名/IP 声誉、认证、加密）。需先在 Google 完成域名验证。
Microsoft SNDS：通过 /v1/reputationanalytics/snds 和 /v1/reputationanalytics/snds/{ip} 获取 Outlook/Hotmail 数据。
DMARC 报表：在 /v1/dmarc/ 下提供 DMARC 合规聚合数据，需先配置 DMARC DNS 记录。
告警：针对黑名单新增、声誉下降等事件提供通知，支持邮件、Slack 和 webhook 渠道，通过 /v1/alerts/events 和 /v1/alerts/settings/events 管理。
使用方式
凭据：使用环境变量存储凭据，切勿在命令或源码中硬编码 API 密钥，例如 export MAILGUN_API_KEY="your-private-api-key"。
认证：Mailgun Optimize 使用 HTTP Basic Auth，用户名为 api，密码为 Mailgun 私有 API 密钥，即 --user "api:$MAILGUN_API_KEY"。
基础 URL：美国区域为 https://api.mailgun.net/，欧盟区域为 https://api.eu.mailgun.net/。
首次调用示例： curl -X GET "https://api.mailgun.net/v1/inboxready/domains" --user "api:$MAILGUN_API_KEY"
语言：可使用任意语言，或直接使用 curl。该 API 仅提供 REST 接口，没有 SDK 封装。
请求/响应模式：请参考 API Reference 或 OpenAPI Spec（见官方文档链接）。
常见工作流
收件箱投放测试：创建种子列表（POST /v4/inbox/seedlists）→ 创建测试（POST /v4/inbox/tests，含 html 正文或 template_name）→ 获取 result_id → 轮询 GET /v4/inbox/results/{result_id}。
送达率审计（用户报告送达问题时按此顺序排查）：检查 IP 黑名单（GET /v1/inboxready/ip_addresses/{ip}），若被列入则优先向黑名单提供方申请移除；检查域名黑名单（GET /v1/monitoring/domains/{domain}/blocklists）；审查垃圾邮件陷阱命中（GET /v2/spamtraps），pristine 陷阱通常意味使用购买/抓取列表，recycled 陷阱通常是列表卫生问题，需做邮箱验证并移除不活跃地址；拉取健康评分（GET /v1/maverick-score/total）；检查 Google Postmaster 声誉（GET /v1/reputationanalytics/gpt/domains/{domain}）；审查 DMARC 合规（GET /v1/dmarc/domains/{domain}）。
新域名接入：注册域名（POST /v1/inboxready/domains?domain=example.com）→ 验证域名（PUT /v1/inboxready/domains/verify?domain=example.com）→ 注册发送 IP（POST /v1/inboxready/ip_addresses）→ 配置告警（POST /v1/alerts/settings/events）→ 设置 DMARC（GET /v1/dmarc/records/{domain} 获取 DNS 记录后配置）→ 关联 Google Postmaster（在 Google 验证域名后确认数据）。
设置监控告警：通过 POST /v1/alerts/settings/events 创建，PUT 更新，DELETE /v1/alerts/settings/events/{id} 删除。
适用场景与限制
适用于邮件发送基础设施监控、投放效果测试、送达率问题排查和域名声誉管理等场景。
限制与注意事项：Google Postmaster 需先在 Google 完成域名验证；垃圾邮件陷阱缓解不可尝试识别具体陷阱地址，应通过邮箱验证清理整个列表并实施双重确认（double opt-in）；黑名单移除需查对应提供方的移除流程，Mailgun 仅监控，不自动移除；DMARC 报表数据需先配置 DMARC DNS 记录。
安全方面：不得在客户端代码、日志或已提交源码中暴露 MAILGUN_API_KEY；Optimize 使用与 Send 相同的 Mailgun 账户凭据，密钥泄露将导致账户级权限外泄；凭据应来自环境变量或密钥管理器；声誉与投放数据可能包含域名级细节，未经同意不应对外分享；密钥泄露应立即在 Mailgun 仪表板轮换。URL 抓取仅限可信一方域名（documentation.mailgun.com、developers.sinch.com）。