快速使用API和SMTP发信的流程简化说明。
为了您快速了解邮件推送产品,您可以浏览如下流程图,对应节点可以在文档中找到具体解释。
开通邮件推送服务
主账号开通:主账号登录邮件推送产品页面,在邮件推送产品页面,选择立即购买购买邮件推送资源包(预付费)或立即开通直接开通按量付费(后付费)。
子账号开通:如果希望子账号开通邮件推送,需要主账号在RAM控制台赋予子账号如下两个权限点AliyunDirectMailFullAccess和 AliyunDirectMailReadOnlyAccess
选择发信区域
目前有华东、新加坡、美国和德国四个集群。四个区域的域名和发信地址互相不通,在某个区域创建的发信地址只能使用相应区域的控制台、API或者SMTP服务发信。
如何选择发信区域:
1、前提:不同的地域决定了数据落地的地域。如果涉及境外客户,请先咨询您公司的法务,数据在哪个区域才合规。
2、如果您的发信程序部署在境内,建议您选择华东1区域。
3、如果您的发信程序部署在境外,且收信地址境外居多,建议您使用新加坡、美国和德国集群。
4、如果您的发信程序部署在境外,且收信地址境内居多:
a)如果您的发信程序使用SMTP发信,且部署在美国或者新加坡,建议您使用华东1区域,会自动通过美国或者新加坡加速节点路由到华东1节点。
b)其他情况,建议您使用新加坡区域。
创建和配置域名
在您使用邮件推送产品时,第一步是需要创建发信域名。设置域名分为自动配置和手动配置,设置域名的具体步骤请参考发送邮件的配置步骤简化说明的Step 1-Step 4。
创建发信地址
新建发信地址:发信地址就是您通过邮件推送平台发信后,收件人收到的邮件中所显示的发件人的邮件地址。
验证回信地址:在设置发信地址时,您可以设置回信地址以接收回信。
设置SMTP密码:如果您需要使用SMTP发信方式,可以设置该发信地址对应的SMTP 密码。
具体步骤请参考设置发信地址。
API发信
API服务地址:参考API服务地址文档
发送邮件的接口:单一发信接口SingleSendMail,批量发信接口BatchSendMail
API的调用方式有两种分别是:签名机制和SDK,两种方式都提供了相应的示例代码,SDK是用户使用比较多的一种方式。这边介绍下SDK方式。
签名机制:参考签名机制文档
SDK:
1、OpenAPI自动生成代码的方式。通过OpenAPI进行调试,选择开发语言,填写参数,下载自动生成的代码。SDK 版本分为升级版和原版,推荐使用升级版。
2、其他SDK的方式。通过SDK参考里面的示例文档下载所需的SDK包或者通过Maven进行安装,再根据提供的发送邮件示例发信。
注意:在代码中需要填入相应的"accessKeyId","accessKeySecret"值,AccessKey ID和AccessKey Secret是您访问阿里云API的密钥,这个要在控制台的AccessKey管理创建AccessKey。
SMTP发信
SMTP 服务地址:参考SMTP服务地址文档
SMTP发信示例:
官方文档已经提供了多种开发语言,可以通过SMTP参考文档跳转选择对应语言的代码示例。以用的比较多的Java代码为例:
1、配置好Java的开发环境和下载相应的代码编辑工具。
2、找到SMTP之Java调用示例,按图标复制所有的代码放到编辑工具里面,替换您配置的参数信息,就可以实现发信。
发送数据统计
查看主账户下全部发信地址的发出的邮件汇总数据,有两种方式:
1、通过邮件推送控制台>数据统计模块可以查看发送数据,具体的发信详情,查看无效地址,具体步骤可以参考数据统计文档。
2、通过发送数据相关接口查询,目前提供5个相关接口,接口介绍请参考发送数据相关接口文档,调用方式参考上面API发信里面介绍的API的调用。