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】賽郵雲通信