sendgrid-python：用 Python 发邮件，几行代码搞定

文章目录sendgrid-python用 Python 发邮件几行代码搞定安装很简单发邮件有两种写法不止发邮件什么场景适合用小结小结sendgrid-python用 Python 发邮件几行代码搞定最近留意到一个邮件发送的 Python 库sendgrid-python。它在 GitHub 上有 1,628 个 Star数量不算多但解决的是个实在问题。很多开发者都遇到过这种情况项目需要发邮件用 Python 自带的 smtplib 也能写但配置麻烦成功率低进垃圾箱的概率还高。走第三方邮件服务的 API 会更稳一些sendgrid-python 就是 SendGrid 服务的官方 Python SDK。这个库封装了 SendGrid Web API v3 的全部端点最常用的功能就是发邮件也支持查询退信、处理入站邮件等。对需要集成邮件功能的 Python 项目来说是个省事的方案。安装很简单直接用 pip 装pipinstallsendgrid依赖只有两个Python-HTTP-Client 和 Cryptography。Python 版本要求 2.7 以上。使用时需要配置 SENDGRID_API_KEY 环境变量在 SendGrid 后台申请一个就行。配好一次后续不用再管。Mac 和 Windows 的环境变量配置方式文档里都写了复制粘贴就能用。发邮件有两种写法这个库提供了两种使用方式看你喜欢哪种。第一种是用 Mail 辅助类这是最省事的写法importsendgridimportosfromsendgrid.helpers.mailimport*sgsendgrid.SendGridAPIClient(api_keyos.environ.get(SENDGRID_API_KEY))from_emailEmail(testexample.com)to_emailTo(testexample.com)subjectSending with SendGrid is FuncontentContent(text/plain,and easy to do anywhere, even with Python)mailMail(from_email,to_email,subject,content)responsesg.client.mail.send.post(request_bodymail.get())几行代码就能发一封邮件。Mail 类会自动帮你处理 personalization 对象不用手动拼 JSON。对大多数场景来说这种写法够用了。第二种是直接调 API自己组装请求体sgsendgrid.SendGridAPIClient(api_keyos.environ.get(SENDGRID_API_KEY))data{personalizations:[{to:[{email:testexample.com}],subject:Sending with SendGrid is Fun}],from:{email:testexample.com},content:[{type:text/plain,value:and easy to do anywhere, even with Python}]}responsesg.client.mail.send.post(request_bodydata)这种方式更灵活适合需要精细控制的场景。比如要加附件、用模板、批量发送都可以在这种结构上做扩展。文档里还有更完整的示例需要的时候可以查。不止发邮件除了发邮件这个库还支持 SendGrid v3 的所有 API 端点。比如查退信列表responsesg.client.suppression.bounces.get()支持流式接口的写法代码链条清晰。也支持传统的路径字符串方式responsesg.client._(suppression/bounces).get()另外还带了入站邮件解析的辅助模块可以处理通过 webhook 接收到的邮件。这个功能在需要做邮件自动回复或工单系统的场景里会用到。什么场景适合用如果你的项目需要发事务性邮件比如注册验证码、密码重置、通知推送这个库很合适。API 方式比 SMTP 稳定送达率也更高。SendGrid 有免费额度小项目够用了。如果你要做复杂的邮件路由、解析可能需要更多基础设施。但作为发送端sendgrid-python 够用了。文档里还有常见用例的示例代码照着改就行。代码是 MIT 协议的可以商用。社区也比较活跃有问题能查到解决方案。小结sendgrid-python 是个务实的工具。代码简洁文档完整几行代码就能集成邮件发送。对于需要邮件功能的 Python 项目来说值得试试。题能查到解决方案。小结sendgrid-python 是个务实的工具。代码简洁文档完整几行代码就能集成邮件发送。对于需要邮件功能的 Python 项目来说值得试试。