快速使用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的调用。