內容目录

上一个主题

定时任务

下一个主题

中文分词

云邮件

服务概述

云邮件是基于新浪邮箱开发的分布式、异步邮件发送服务,相对普通 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()。

使用示例

  1. 快速发送一份邮件

    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))
    
  2. 发送邮件给多个收件人

    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))
    
  1. 发送一封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()
    
  2. 使用Gmail SMTP

    import sae.mail
    
    sae.mail.send_mail(to, subject, body,
            ('smtp.gmail.com', 587, from, passwd, True))