当前位置：首页 > news >正文

sendgrid-python：用 Python 调用 SendGrid 邮件 API

news 2026/6/10 13:25:22

文章目录

sendgrid-python：用 Python 调用 SendGrid 邮件 API
- 1、这项目是干嘛的
- 2、安装和配置
- 3、发一封邮件有多简单
- 4、不止能发邮件
- 5、适合哪些人用

sendgrid-python：用 Python 调用 SendGrid 邮件 API

sendgrid-python 在 GitHub 上已经拿到 1,628 Star。

这是 Twilio SendGrid 官方维护的 Python SDK，作用很明确：让你在 Python 项目里直接调用 SendGrid Web API v3，完成邮件发送、入站邮件处理以及其他 API 操作。

1、这项目是干嘛的

如果你需要在 Python 应用里发邮件，又不想自己拼装 SMTP 请求或者处理复杂的邮件协议，这个库可以省掉很多麻烦。

它封装了 SendGrid v3 的全部接口，核心就是围绕/mail/send端点提供的一组 Helper，同时也支持直接访问其他 v3 端点。开发者可以用两种方式使用它：一种是直接构造 JSON 请求体，另一种是调用库内置的Mail辅助类。

除了发邮件，它还提供了 Inbound Parse 的辅助模块，用来处理接收到的邮件。对于需要把邮件接收和解析自动化的场景，这个模块能减少很多重复代码。

项目的依赖很少，主要包括Python-HTTP-Client和Cryptography，安装过程不会拖进一堆用不上的包。

2、安装和配置

安装命令很简单：

pipinstallsendgrid

环境要求不高，Python 2.7 及以上版本都可以运行。如果你正在维护一个比较老的项目，也不用担心兼容性问题。

使用前需要设置SENDGRID_API_KEY。Mac 或 Linux 环境下可以执行：

echo"export SENDGRID_API_KEY='YOUR_API_KEY'">sendgrid.envecho"sendgrid.env">>.gitignoresource./sendgrid.env

Windows 下则用set或setx命令写入环境变量。项目也支持.env文件，复制.env_sample后填入 key 即可。

3、发一封邮件有多简单

用Mail辅助类只需要几行代码：

importsendgridimportosfromsendgrid.helpers.mailimport*sg=sendgrid.SendGridAPIClient(api_key=os.environ.get('SENDGRID_API_KEY'))from_email=Email("test@example.com")to_email=To("test@example.com")subject="Sending with SendGrid is Fun"content=Content("text/plain","and easy to do anywhere, even with Python")mail=Mail(from_email,to_email,subject,content)response=sg.client.mail.send.post(request_body=mail.get())print(response.status_code)print(response.body)print(response.headers)

如果你不想用辅助类，也可以直接传 JSON：

importsendgridimportos sg=sendgrid.SendGridAPIClient(api_key=os.environ.get('SENDGRID_API_KEY'))data={"personalizations":[{"to":[{"email":"test@example.com"}],"subject":"Sending with SendGrid is Fun"}],"from":{"email":"test@example.com"},"content":[{"type":"text/plain","value":"and easy to do anywhere, even with Python"}]}response=sg.client.mail.send.post(request_body=data)print(response.status_code)

两种方式返回的结果都包含状态码、响应体和响应头，便于你做后续判断。

4、不止能发邮件

这个 SDK 同时支持 SendGrid v3 的其他端点，比如查询退信列表：

importsendgridimportos sg=sendgrid.SendGridAPIClient(api_key=os.environ.get('SENDGRID_API_KEY'))response=sg.client.suppression.bounces.get()print(response.status_code)print(response.body)print(response.headers)

它提供了 Fluent 风格的调用链，也支持用字符串路径直接访问 API。这意味着你既可以用sg.client.suppression.bounces.get()这种链式写法，也可以用sg.client._("suppression/bounces").get()这种更直接的方式。对于习惯了 RESTful 路径的开发者来说，第二种写法可能更容易对应到官方文档的接口说明。

项目在持续维护中，更新记录和发布信息都写在了 CHANGELOG 里。遇到问题时可以先查看自带的 TROUBLESHOOTING 文档，常见问题基本都有覆盖。