Sendgrid

简介

SendGrid（Twilio SendGrid）v3 API 发送事务性和营销邮件，管理已验证发件人、模板和分析。认证是简单的 API 密钥（实测：无密钥请求返回 401）。免费层覆盖个人项目的轻量发送。

快速开始

发送邮件（替换 YOUR_KEY）：

curl -X POST "https://api.sendgrid.com/v3/mail/send" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "personalizations": [{"to": [{"email": "[email protected]"}]}],
    "from": {"email": "[email protected]"},
    "subject": "Hello",
    "content": [{"type": "text/plain", "value": "Hello from SendGrid!"}]
  }'

统计：

curl "https://api.sendgrid.com/v3/stats" -H "Authorization: Bearer YOUR_KEY"

已验证发件人 / 模板：

curl "https://api.sendgrid.com/v3/verified_senders" -H "Authorization: Bearer YOUR_KEY"
curl "https://api.sendgrid.com/v3/templates" -H "Authorization: Bearer YOUR_KEY"

认证方式

• 在 app.sendgrid.com（Settings → API Keys）创建带 scope 的 API 密钥（如 mail.send）。
• 通过 Authorization: Bearer YOUR_KEY 发送（无效密钥返回 401——已实测）。
• 发送前需要已验证发件人（域名或单个发件人）。

速率限制与注意事项

• 免费层：100 封邮件/天；付费档可扩展。
• mail/send 端点是主力——支持附件、模板和动态字段。
• 所有请求走 api.sendgrid.com/v3/；错误以 JSON 返回并带消息。
• 接收邮件可考虑 Inbound Parse webhook（需单独配置）。

常见问题

SendGrid 免费吗？ 免费层：100 封/天；付费档可扩展。

如何获取密钥？ app.sendgrid.com → Settings → API Keys → Create。

需要已验证发件人吗？ 是的——发送前需验证域名或单个发件人。