天天看點

阿裡短信服務API接入指南及示例

阿裡短信服務,用淘寶賬号打通三大營運商通信能力,以開放api方式向開發者提供短信服務。阿裡短信服務具備3秒可達、99%到達率和超低資費的優勢,并完美支撐了雙11“2億使用者,6億短信,8萬并發”的挑戰。本文将介紹阿裡短信服務api的接入方法,并提供了多種程式設計語言的調用示例。

訂購阿裡短信服務後,就可以設定短信簽名和短信模闆,然後可基于api gateway sdk實作api調用。

注意:短信簽名和模闆是必須的,而且要通過稽核後方可使用,不允許随意發送短信。

短信簽名為驗證碼短信或者通知短信内容中【】内的名稱,一般為公司或者産品名,如【阿裡雲】。

點選“簽名”标簽,點選“建立短信簽名”,根據下方文字說明,建立簽名。

阿裡短信服務API接入指南及示例

建立簽名時,要上傳 企業營業執照,組織機構代碼證、稅務登記證 三個證件的圖檔,如果是三證合一,則上傳三張同樣的圖檔即可。如果是要使用他人公司的名稱,則要上傳授權委托書、授權機關的組織機構代碼證的圖檔。

簽名送出後,要等待稽核,一般在1個工作日内完成。稽核通過的簽名方能使用。簽名稽核通過後,請留意“簽名名稱”,在api調用的時候将會使用到這個參數。

個人使用者最多可以建立1個自定義短信簽名;企業使用者最多可以建立5個自定義短信簽名。

短信模闆就是短信正文的模闆。

點選“模闆”标簽,點選“建立模闆”,根據正文文字說明,建立模闆。

阿裡短信服務API接入指南及示例

填寫内容确定之後,點選“送出稽核”。稽核将在1個工作日内完成。同樣,隻有稽核通過的模闆才能使用。模闆稽核通過後,請留意“模闆code”,在api調用的時候将會使用到這個參數。

模闆最多可添加20個。

為了保證安全,api請求需要有帶上簽名。api gateway的簽名機制比較複雜,一般使用者可直接使用sdk和參考下一章節的調用示例直接調用短信服務api。如果你使用的程式設計語言,我們還沒有提供sdk和示例,則需要你參考以下文檔,自行實作簽名。

<a href="https://help.aliyun.com/document_detail/29475.html?spm=5176.doc29490.2.2.zip6xz">api gateway 請求簽名機制說明</a>

api調用的sdk及調用示例将在下一章節介紹。

1)api基礎參數

2)appcode或者appkey&amp;appsecret

阿裡短信服務API接入指南及示例

3)簽名名稱及模闆code

簽名名稱:

阿裡短信服務API接入指南及示例

模闆code:

阿裡短信服務API接入指南及示例

4)模闆變量

模闆變量為建立模闆的時你自定義的變量。這些變量的值可在調用api時進行設定。api參數中<code>paramstring</code>即為模闆變量,形式為json字元串。其中,數字必須轉換為字元串。個人使用者<code>paramstring</code>變量長度必須小于15個字元。

舉例:

若短信模闆為:“你好,你的驗證碼為:${no},不要告訴别人哦”,此時你如果将參數<code>paramstring=‘{“no”:”123456”}’</code>,使用者收到的短信内容将為:【短信簽名】你好,你的驗證碼為:123456,不要告訴别人哦。

提示:如果你的模闆中沒有變量,則<code>paramstring={}</code>。

5)目标手機号

支援批量發送給多個手機号。參數名為<code>recnum</code>,多個手機号之間以英文逗号分割。

資料市場現已支援兩種api調用方式,一種為appcode簡單身份認證模式,另一種為appkey&amp;appsecret簽名認證模式。推薦使用appcode模式,簡單易用。如果你對安全有更高要求,則可以繼續采用appkey&amp;appsecret簽名認證模式。

java版本依賴于java sdk,請注意代碼其中的注釋說明,下載下傳java sdk後使用以下代碼。

其他語言,如php、c#、objective-c,請直接參考商品詳情頁中的描述。

2)在 <code>src/main/java/com/aliyun/api/gateway/demo</code> 目錄下建立代碼檔案singlesendsms.java,複制如下代碼(自行修改相關參數):

3)編譯後執行singlesendsms類即可發送短信。

2) 修改 <code>com/aliyun/api/gateway/sdk/clientdemo.py</code> 的代碼為(自行替換相應的參數内容):

3)執行 com/aliyun/api/gateway/sdk/clientdemo.py 即可發送短信。

如果不想使用python sdk,則可以使用如下更為精簡的代碼自行實作api簽名和api調用:

shell版本的代碼比較精簡,替換相關參數後就可以直接使用。其他語言也可以通過調用shell腳本發送短信。

2)建立一個工程,并依賴于.net sdk,再建立一個singlesendsms類,代碼如下(自行修改相關參數):

3)執行singlesendsms中的main函數就可以發送短信。

php版本的代碼比較精簡,替換相關參數後就可以直接使用。

1)建立一個signature類,類的實作代碼如下(請自行修改appkey和appsecret):

調用方法:

swift腳本可以通過調用object-c代碼實作短信發送。

如果你使用的程式設計語言未在上述調用示例之内,你可以根據簽名說明文檔自行實作。也可以通過調用shell腳本發送短信。

如有其他問題,可以加入我們的客戶支援群(群号:1639868142),有專門的小二會提供咨詢。

enjoy it~