快速使用API和SMTP發(fā)信的流程簡化說明
快速使用API和SMTP發(fā)信的流程簡化說明。
為了您快速了解郵件推送產(chǎn)品,您可以瀏覽如下流程圖,對(duì)應(yīng)節(jié)點(diǎn)可以在文檔中找到具體解釋。
開通郵件推送服務(wù)
主賬號(hào)開通:主賬號(hào)登錄郵件推送產(chǎn)品頁面,在郵件推送產(chǎn)品頁面,選擇立即購買購買郵件推送資源包(預(yù)付費(fèi))或申請(qǐng)開通直接開通按量付費(fèi)(后付費(fèi))。
子賬號(hào)開通:如果希望子賬號(hào)開通郵件推送,需要主賬號(hào)在RAM控制臺(tái)賦予子賬號(hào)如下兩個(gè)權(quán)限點(diǎn)AliyunDirectMailFullAccess和 AliyunDirectMailReadOnlyAccess
注意:阿里云實(shí)名認(rèn)證用戶才可以購買和開通郵件推送產(chǎn)品,請(qǐng)確保賬號(hào)已完成實(shí)名認(rèn)證。 單擊這里去實(shí)名認(rèn)證。
選擇發(fā)信區(qū)域
目前有華東、新加坡、美國和德國四個(gè)集群。四個(gè)區(qū)域的域名和發(fā)信地址互相不通,在某個(gè)區(qū)域創(chuàng)建的發(fā)信地址只能使用相應(yīng)區(qū)域的控制臺(tái)、API或者SMTP服務(wù)發(fā)信。
如何選擇發(fā)信區(qū)域:
1、前提:不同的地域決定了數(shù)據(jù)落地的地域。如果涉及境外客戶,請(qǐng)先咨詢您公司的法務(wù),數(shù)據(jù)在哪個(gè)區(qū)域才合規(guī)。
2、如果您的發(fā)信程序部署在境內(nèi),建議您選擇華東1區(qū)域。
3、如果您的發(fā)信程序部署在境外,且收信地址境外居多,建議您使用新加坡、美國和德國集群。
4、如果您的發(fā)信程序部署在境外,且收信地址境內(nèi)居多:
a)如果您的發(fā)信程序使用SMTP發(fā)信,且部署在美國或者新加坡,建議您使用華東1區(qū)域,會(huì)自動(dòng)通過美國或者新加坡加速節(jié)點(diǎn)路由到華東1節(jié)點(diǎn)。
b)其他情況,建議您使用新加坡區(qū)域。
創(chuàng)建和配置域名
在您使用郵件推送產(chǎn)品時(shí),第一步是需要?jiǎng)?chuàng)建發(fā)信域名。設(shè)置域名分為自動(dòng)配置和手動(dòng)配置,設(shè)置域名的具體步驟請(qǐng)參考發(fā)送郵件的配置步驟簡化說明的Step 1-Step 4。
創(chuàng)建發(fā)信地址
新建發(fā)信地址:發(fā)信地址就是您通過郵件推送平臺(tái)發(fā)信后,收件人收到的郵件中所顯示的發(fā)件人的郵件地址。
驗(yàn)證回信地址:在設(shè)置發(fā)信地址時(shí),您可以設(shè)置回信地址以接收回信。
設(shè)置SMTP密碼:如果您需要使用SMTP發(fā)信方式,可以設(shè)置該發(fā)信地址對(duì)應(yīng)的SMTP 密碼。
具體步驟請(qǐng)參考設(shè)置發(fā)信地址。
API發(fā)信
API服務(wù)地址:參考API服務(wù)地址
發(fā)送郵件的接口:單一發(fā)信接口SingleSendMail,批量發(fā)信接口 BatchSendMail
API的調(diào)用方式有兩種分別是:簽名機(jī)制和SDK,兩種方式都提供了相應(yīng)的示例代碼,SDK是用戶使用比較多的一種方式。這邊介紹下SDK方式。
簽名機(jī)制:參考簽名機(jī)制
SDK:
1、OpenAPI自動(dòng)生成代碼的方式。通過OpenAPI進(jìn)行調(diào)試,選擇開發(fā)語言,填寫參數(shù),下載自動(dòng)生成的代碼。SDK 版本分為升級(jí)版和原版,推薦使用升級(jí)版。
2、其他SDK的方式。通過SDK參考里面的示例文檔下載所需的SDK包或者通過Maven進(jìn)行安裝,再根據(jù)提供的發(fā)送郵件示例發(fā)信。
注意:在代碼中需要填入相應(yīng)的"accessKeyId","accessKeySecret"值,AccessKey ID和AccessKey Secret是您訪問阿里云API的密鑰,這個(gè)要在控制臺(tái)的AccessKey管理創(chuàng)建AccessKey。
SMTP發(fā)信
SMTP 服務(wù)地址:參考SMTP 服務(wù)地址
SMTP發(fā)信示例:
官方文檔已經(jīng)提供了多種開發(fā)語言,可以通過SMTP 參考文檔跳轉(zhuǎn)選擇對(duì)應(yīng)語言的代碼示例。以用的比較多的Java代碼為例:
1、配置好Java的開發(fā)環(huán)境和下載相應(yīng)的代碼編輯工具。
2、找到SMTP 之 Java 調(diào)用示例,按圖標(biāo)復(fù)制所有的代碼放到編輯工具里面,替換您配置的參數(shù)信息,就可以實(shí)現(xiàn)發(fā)信。
發(fā)送數(shù)據(jù)統(tǒng)計(jì)
查看主賬戶下全部發(fā)信地址的發(fā)出的郵件匯總數(shù)據(jù),有兩種方式:
1、通過郵件推送控制臺(tái)>數(shù)據(jù)統(tǒng)計(jì)模塊可以查看發(fā)送數(shù)據(jù),具體的發(fā)信詳情,查看無效地址,具體步驟可以參考數(shù)據(jù)統(tǒng)計(jì)。
2、通過發(fā)送數(shù)據(jù)相關(guān)接口查詢,目前提供5個(gè)相關(guān)接口,接口介紹請(qǐng)參考發(fā)送數(shù)據(jù)相關(guān)接口文檔,調(diào)用方式參考上面API發(fā)信里面介紹的API的調(diào)用。