文档

快速使用API和SMTP发信的流程简化说明

更新时间:
一键部署

快速使用API和SMTP发信的流程简化说明。

为了您快速了解邮件推送产品,您可以浏览如下流程图,对应节点可以在文档中找到具体解释。

089c66948401d703f1dbf39ecafb0e91.png

开通邮件推送服务

  • 主账号开通:主账号登录邮件推送产品页面,在邮件推送产品页面,选择立即购买购买邮件推送资源包(预付费)或申请开通直接开通按量付费(后付费)。

  • 子账号开通:如果希望子账号开通邮件推送,需要主账号在RAM控制台赋予子账号如下两个权限点AliyunDirectMailFullAccess和 AliyunDirectMailReadOnlyAccess

注意:阿里云实名认证用户才可以购买和开通邮件推送产品,请确保账号已完成实名认证。 单击这里去实名认证。

选择发信区域

目前有华东新加坡澳洲三个集群。三个区域的域名和发信地址互相不通,在某个区域创建的发信地址只能使用相应区域的控制台、API或者SMTP服务发信。

image.png

如何选择发信区域:

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 版本分为升级版和原版,推荐使用升级版。openapi

2、其他SDK的方式。通过SDK参考里面的示例文档下载所需的SDK包或者通过Maven进行安装,再根据提供的发送邮件示例发信。

旧版SDK

注意:在代码中需要填入相应的"accessKeyId","accessKeySecret"值,AccessKey ID和AccessKey Secret是您访问阿里云API的密钥,这个要在控制台的AccessKey管理创建AccessKey。

accesskey

SMTP发信

SMTP 服务地址:参考SMTP 服务地址文档

SMTP发信示例:

官方文档已经提供了多种开发语言,可以通过SMTP 参考文档跳转选择对应语言的代码示例。SMTP发信以用的比较多的Java代码为例:

1、配置好Java的开发环境和下载相应的代码编辑工具。

2、找到SMTP之Java调用示例,按图标复制所有的代码放到编辑工具里面,替换您配置的参数信息,就可以实现发信。

复制代码

发送数据统计

查看主账户下全部发信地址的发出的邮件汇总数据,有两种方式:

1、通过邮件推送控制台>数据统计模块可以查看发送数据,具体的发信详情,查看无效地址,具体步骤可以参考数据统计文档数据统计

2、通过发送数据相关接口查询,目前提供5个相关接口,接口介绍请参考发送数据相关接口文档,调用方式参考上面API发信里面介绍的API的调用。发送数据相关接口

  • 本页导读 (0)
文档反馈