SUBMAIL賽郵雲通信短信接口調用教程,一分鐘集成

SUBMAIL賽郵雲通信短信接口調用教程,一分鐘集成

 

 創建賬戶

在進行短信接口調用前,請在官網https://www.mysubmail.com/先完成您的賬戶創建並登陸(企業用戶需要上傳有效的營業執照掃描件,機構/政府企事業單位請上傳有效的組織機構代碼證掃描件;個人開發者需要上傳個人身份證正反面,並附上一張手持身份證拍照圖片一併上傳,同時個人開發者僅限於使用事務類短信,不支持營銷類短信。)


 創建短信模板

登入短信後臺,創建新的短信模板。創建步驟如下:

創建/管理短信項目模板-》創建新模板-》在彈出框內輸入模板內容和短信簽名,最後點擊“提交審覈”。審覈通過即完成新短信模板的創建。請注意:如您發送的短信帶有變量,那麼必須創建帶有變量的模板,所以短信模板創建有兩種,爲變量模板和無變量模板。


提醒:創建或更新模板需要人工審覈,模板審覈時間一般爲工作日(週一至週五):上午8:00-凌晨12:00; 法定假期和雙休日:上午11:00-凌晨12:00,工作時間一般爲1-5分鐘以內審覈完成。

 

 創建APPID

創建新的APPID 用於短信 WEB API 請求;或更新您的APPID 權限、狀態和安全設置。創建步驟如下:

創建/管理APPID-》創建APPID-》在彈出框中輸入APPID名稱,即完成APPID的創建。

  

 創建地址簿

短信地址簿爲短信接受方的手機號集合文件,創建步驟如下:

創建/管理手機地址簿-》新建地址簿-》輸入地址簿名稱-》導入聯繫人-》創建完成。但是請注意,在導入聯繫人時有兩種,分別是直接輸入和從文件導入。

 

調用接口

1、前往-》開發者 -》SDK開發包下載頁面,下載對應語言的SDK開發包。(本文將以世界上最好的語言php爲例)。

SUBMAIL 提供多達9種語言的開發包,SDK集成了 SUBMAIL 的API請求方法,並將API中的參數進行封裝,開發者僅需下載對應語言的開發包即可快速配置短信服務。詳情如下圖所示:

 

 

2、將已創建的應用ID和應用密鑰複製到開發包的配置文件內

以PHP SDK爲例,請將APPID和應用密鑰複製到app_config.php文件內的對應位置,詳情如下圖所示:

 

 

各語言的配置文件對應清單:

 

PHP =>/path/to/app_config.php

JAVA =>/path/to/app_config.properties

C# =>/path/to/AppConfigs.cs

PYTHON=> /path/to/app_configs.py

RUBY=>  /path/to/submaildemo.rb

GO =>/path/to/main.go

OBJECTIVE-C=> /path/to/config/SMConfig.h

SWIFT=>  /path/to/config/Config.swift

Node.js=> /path/to/config.js

複製/粘貼後保存該配置文件,進行下一步;

 

3、本文以 PHP 開發包爲例,其他語言可作爲參考,具體文件和目錄可能略有不同

(1)打開下載的開發包中 DEMO 目錄下message_xsend_demo.php 文件;

(2)將短信-》項目中需要發送的模板的項目ID複製到 $submail->SetProject('xxxxx')方法中,替換'xxxxx'部分;

(3)使用$submail->AddVar()方法,替換模板中申明的@var(code) 變量。addvar方法有2個必選參數,第一個參數爲變量名(本實例中即 code),第二個參數爲該變量的值,例如:$submail->AddVar('code','198277');  即將短信模板中 @var(code) 變量,替換爲'198277'。addVar 方法可多次調用;

(4)在$submail->setTo('15*********');參數中填寫接收者的手機號碼;

 完整的代碼如下圖所示:

 

 

保存該demo文件,運行即可發送該短信。

以上代碼輸出的短信爲:您的驗證碼:198277,請在30分鐘內輸入,如非本人操作請忽略。【SUBMAIL】賽郵雲通信

 

 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章