云邮件¶
服务概述¶
云邮件是基于新浪邮箱开发的分布式、异步邮件发送服务，相对普通 SMTP 邮件，云邮件具有到达率高、可靠性高等特点，以及完善的日志信息和发送统计服务，尤其是使用新浪免费邮箱作为发件人邮箱时，其到达率和商业 EDS 模式到达率相近。
邮件的发送的日志可以在『日志中心 / 云邮件』中查看。
- 用户发送邮件数量：根据云邮件分钟配额，每分钟发送邮件不超过 500 封，如果您短时间有大量邮件需要发送，可以使用第三方邮件群发服务。
- 邮件每天发送量不得超过天等级配额，每月发送量不得超过月等级配额。
- 邮件标题最大字节数 <= 256B 。
- 单封邮件总大小（含附件） <= 10M 。
- 每封邮件最多可同时抄送给 10 个邮箱 。
- 每天向同一用户发送同一内容邮件不得超过两封，否则将会拒发 。
- 为了保证您的邮件的到达率，我们强烈建议使用新浪免费邮箱进行邮件发送 。
- 云邮件目前支持 SMTP，为了保证账号安全，建议用户注册新的专用于新浪云的邮件发送的 Email，和日常所用账号区分 。
- 用户发送的邮件不得违背国内法律法规，不得从事不良行为（如发送垃圾邮件、广告邮件）。如发现，导致用户邮件账号不能使用，新浪云不承担责任 。
API使用手册¶
-
class
sae.mail.EmailMessage(**kwargs)¶ EmailMessage类
参数同下面的initialize
-
initialize(**kwargs)¶ 初始化邮件的内容。
参数: - to – 收件人，收件人邮件地址或者收件人邮件地址的列表。
- subject – 邮件的标题。
- body/html – 邮件正文。如果内容为纯文本，使用body，如果是html则使用html。
- smtp – smtp服务器的信息。是一个包含5个元素的tuple。(smtp主机，smtp端口， 邮件地址或用户名，密码，是否启用TLS）。
- from_addr – 可选。发件人，邮件的from字段，默认使用smtp的配置信息。
- attachments – 可选。邮件的附件，必须为一个list，list里每个元素为一个tuple，tuple的第一个元素为文件名，第二个元素为文件的内容。
-
send()¶ 提交邮件发送请求至后端服务器。
-
__setattr__(attr, value)¶ 参数: - attr – 属性名。
- value – 属性的值。
-
-
sae.mail.send_mail(to, subject, body, smtp, **kwargs)¶ 快速发送邮件。
字段的意义同EmailMessage.initialize()。
使用示例¶
快速发送一份邮件
from sae.mail import send_mail send_mail("katherine@vampire.com", "invite", "to tonight's party", ("smtp.vampire.com", 25, "damon@vampire.com", "password", False))
发送邮件给多个收件人
to = ["katherine@vampire.com", 'rebecca@vampire.com', 'elena@vampire.com'] send_mail(to, "invite", "to tonight's party", ("smtp.vampire.com", 25, "damon@vampire.com", "password", False))
发送一封html格式的邮件
from sae.mail import EmailMessage m = EmailMessage() m.to = 'damon@vampire.com' m.subject = 'Re: inivte' m.html = '<b>my pleasure!</b>' m.smtp = ('smtp.vampire.com', 25, 'katherine@vampire.com', 'password', False) m.send()
使用Gmail SMTP
import sae.mail sae.mail.send_mail(to, subject, body, ('smtp.gmail.com', 587, from, passwd, True))