SuperAPI AI 工具集

sinch-mailgun-inspect

编程与开发

查看项目

更新于 10-16 09:29

技能介绍

用途:Mailgun Inspect(由 Sinch 提供)是邮件发送前的质量控制 API,用于在正式发送前检查邮件质量并预览渲染效果。

主要能力:无障碍检查(/v1/inspect/accessibility,输入 html 与 encoded)、链接验证(/v1/inspect/links,输入 URL 数组,或 /html-validate 传 HTML)、图片验证(/v1/inspect/images,输入 URL 数组,或 /html-validate、/upload)、代码分析(/v1/inspect/analyze,输入 html,无 encoded 字段)、邮件预览(/v1/preview/tests 与 /v2/preview/tests)。

使用方式:仅 REST,无 SDK 封装;HTTP Basic Auth,用户名 api、密码为 Mailgun 私有 API Key。密钥放环境变量,例如 export MAILGUN_API_KEY="your-private-api-key",请求用 --user "api:$MAILGUN_API_KEY"。区域需与账号一致:美国 api.mailgun.net,欧盟 api.eu.mailgun.net。创建端点通常异步,需轮询 GET 直到状态为 Complete 或 Completed,Failed 视为终止错误。所有请求 Content-Type 为 application/json;无障碍创建返回 201,其余返回 200。

适用场景:发送前综合质检(并行运行四项 HTML 测试)、CI/CD 质量门禁、图片校验后优化、代码分析按客户端支持筛选(如 support_type=n&application_type=web)。

限制与注意:V2 预览可通过 POST /v2/preview/tests 一次触发四项内容检查;列表端点支持 limit(最大 1000,默认 100)与 skip。密钥泄漏将同时影响发送权限,须妥善保管并及时轮换。更多请求结构见官方文档与 OpenAPI 规范。