发送邮件 API
通过 HTTP API 发送邮件
有两种 HTTP API 端点可以发送邮件，区别如下：
| 端点 | 认证方式 | 适用场景 |
|---|---|---|
/api/send_mail | Authorization: Bearer <地址JWT> header | 内部调用，需要先通过 cookie / header 鉴权 |
/external/api/send_mail | 请求体中的 token 字段 | 外部系统集成，无需 header 鉴权 |
什么是"地址 JWT"？
地址 JWT 是通过 /api/new_address 或 /admin/new_address 创建邮箱地址时返回的 jwt 字段。 你可以在前端 UI 的「密码」菜单中查看它。它不是 JWT_SECRET 环境变量，也不是 admin 密码。
方式一：通过 Header 认证（/api/send_mail）
python
send_body = {
"from_name": "发件人名字",
"to_name": "收件人名字",
"to_mail": "收件人地址",
"subject": "邮件主题",
"is_html": False, # 根据内容设置是否为 HTML
"content": "<邮件内容：html 或者 文本>",
}
res = requests.post(
"https://你的worker域名/api/send_mail",
json=send_body, headers={
"Authorization": f"Bearer {地址JWT}",
# "x-custom-auth": "<你的网站密码>", # 如果启用了私有站点密码
"Content-Type": "application/json"
}
)方式二：通过 Body Token 认证（/external/api/send_mail）
适合外部系统调用，将地址 JWT 放在请求体的 token 字段中：
python
send_body = {
"token": "<地址JWT>",
"from_name": "发件人名字",
"to_name": "收件人名字",
"to_mail": "收件人地址",
"subject": "邮件主题",
"is_html": False, # 根据内容设置是否为 HTML
"content": "<邮件内容：html 或者 文本>",
}
res = requests.post(
"https://你的worker域名/external/api/send_mail",
json=send_body, headers={
# "x-custom-auth": "<你的网站密码>", # 如果启用了私有站点密码
"Content-Type": "application/json"
}
)通过 SMTP 发送邮件
请先参考 配置 SMTP 代理。
这是一个 python 的例子，使用 smtplib 库发送邮件。
JWT令牌密码: 即为邮箱登录密码，可以在 UI 界面中查看密码菜单中查看。
python
import smtplib
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart
with smtplib.SMTP('localhost', 8025) as smtp:
smtp.login("jwt", "此处填写你的JWT令牌密码")
message = MIMEMultipart()
message['From'] = "Me <[email protected]>"
message['To'] = "Admin <[email protected]>"
message['Subject'] = "测试主题"
message.attach(MIMEText("测试内容", 'html'))
smtp.sendmail("[email protected]", "[email protected]", message.as_string())