sinch-mailgun-validate

用途：通过 Mailgun Validate API 验证邮箱地址、检查可投递性并做列表清洗，适用于注册/结账时实时校验、存量列表质量评估和批量验证。主要能力：单地址验证（GET 或 POST /v4/address/validate，address 最长 512 字符，可加 provider_lookup=false 跳过提供商检查），返回 result（deliverable、undeliverable、do_not_send、catch_all、unknown）、risk（low、medium、high、unknown）、is_disposable_address、is_role_address、did_you_mean、engagement 等字段；列表健康预览为免费非破坏性抽样，接口包括创建、查询状态、提升为完整批量、删除和列出，状态从 preview_processing 到 preview_complete，最多 10 个并行预览任务，响应包裹在 preview 键中；批量验证支持上传不超过 25 MB 的 CSV 或 gzip，接口包括创建、查询状态/下载、取消或删除、列出任务，生命周期为 created→processing→completed→uploading→uploaded（或 failed），最多 5 个并行批量任务。使用方式：凭证存环境变量 export MAILGUN_API_KEY="your-private-api-key"，使用 HTTP Basic Auth（用户名 api，密码为私有 API key），示例如 curl -X GET "https://api.mailgun.net/v4/address/validate?address=recipient@example.com" -s --user "api:$MAILGUN_API_KEY"；区域基址为 api.mailgun.net（美国）或 api.eu.mailgun.net（欧盟），须与账户区域一致；SDK 覆盖 Node.js（npm install mailgun.js）、Java（Maven 依赖 com.mailgun:mailgun-java）、Python（pip install mailgun）、PHP（composer require mailgun/mailgun-php symfony/http-client nyholm/psr7）、Ruby（gem install mailgun-ruby）、Go（go get github.com/mailgun/mailgun-go/v5）。限制与注意：result 与 risk 是独立维度，需同时判断；catch_all 按中等风险处理；一次性地址建议注册时拦截，角色地址不宜用于营销；预览免费，建议先预览再批量；单地址接口有速率限制，遇到 429 需退避重试；批量下载链接会过期应及时获取；美国与欧盟数据不互通；不要把 API key 暴露于客户端、日志或提交的源码；验证涉及 PII，需妥善保护；仅从受信任的第一方域名获取 URL，批量下载内容按不可信数据处理。具体定价、配额与更多字段说明暂未提供。