本文介紹了短信發(fā)送功能的實現(xiàn)。通過本文，用戶可以快速為網站、APP應用和小程序接入短信發(fā)送服務。支持發(fā)送驗證、通知和推廣短信內容。適用于會員注冊、驗證碼登錄、預警通知、物流通知場景。短信可以發(fā)送至全國移動、聯(lián)通、電信運營商手機號碼。

ruby短信接口教程開發(fā)教程

1、免費注冊短信賬號

免費注冊互億無線短信平臺會員(平臺將自動為每位會員免費試用短信)

2、短信發(fā)送邏輯

短信發(fā)送實現(xiàn)流程

3、查看短信API接口文檔

登錄互億無線短信平臺可以查看短信發(fā)送功能使用向導，查看API接口文檔。

接口說明：
1、接口功能：支持短信發(fā)送、回執(zhí)推送、余額查詢、上行回復推送；
2、提交方式：GET/POST；
3、加密方式：
? 采用HTTPS協(xié)議提交請求
? 通過MD5動態(tài)簽名方式加密
4、短信模板：測試期間，須使用系統(tǒng)默認的模板進行測試，默認模板內容：您的驗證碼是：1234。請不要把驗證碼泄露給其他人。
5、短信簽名：調試期間，須使用系統(tǒng)默認簽名【互億無線】

4、查看短信DEMO示例

提供多種開發(fā)接口模式。

5、下載短信插件

提供各類系統(tǒng)的短信插件，無需開發(fā)即可接入短信功能。

6、短信接口提交測試

在頁面中查找專屬的APIID和APIKEY；

通過POST、 GET 方式進行短信提交，數據編碼采用utf-8格式，請求地址為：https://106.ihuyi.com/webservice/sms.php?method=Submit。請求參數如下：

參數名稱	參數值描述	必填
account	APIID(用戶中心【驗證碼通知短信】-【產品縱覽】查看)	是
password	1、APIKEY(用戶中心【驗證碼通知短信】-【產品縱覽】查看) 2、動態(tài)密碼(生成動態(tài)密碼方式請看該文檔末尾的說明)	是
mobile	接收手機號碼，只能提交1個號碼	是
content	短信內容(編碼格式為 UTF-8，支持 300 個字的長短信，長短信 按多條計費) 例如:您的驗證碼是:1234。請不要把驗證碼泄露給其他人。	是
time	Unix時間戳（10位整型數字，當使用動態(tài)密碼方式時為必填）	否
format	返回格式（可選值為：xml或json，系統(tǒng)默認為xml）	否

用戶通過http 或 https提交發(fā)送短信請求到服務器后，服務器會返回一串xml格式的字符串，SubmitResult結構說明如下：

參數名稱	類型	描述
code	int	返回值為2時，表示提交成功
smsid	string	當提交成功后，此字段為流水號，否則為0
msg	string	提交結果描述

響應示例：

運行函數后，查看接口的提交狀態(tài)，確保接口請求提交是成功的，如果不成功，可根據接口返回的狀態(tài)，查到對應的原因，根據具體原因來進行調試。

code	msg
0	提交失敗
2	提交成功
400	非法ip訪問
401	帳號不能為空
402	密碼不能為空
403	手機號碼不能為空
4030	手機號碼已被列入黑名單
404	短信內容不能為空
405	API ID 或 API KEY 不正確
4050	賬號被凍結
40501	動態(tài)密碼已過期
40502	動態(tài)密碼校驗失敗
4051	剩余條數不足
4052	訪問 ip 與備案 ip 不符
406	手機格式不正確
407	短信內容含有敏感字符
4070	簽名格式不正確
4071	簽名格式不正確
4072	簽名格式不正確
40722	變量內容超過指定的長度【8】
4073	短信內容超出長度限制
4074	短信內容包含 emoji 符號
4075	簽名未通過審核
408	發(fā)送超限([20]條)，已加入黑名單，可登入平臺解除
4080	同一手機號碼同一秒鐘之內發(fā)送頻率不能超過 1 條
4082	超出同一手機號一天之內【5】條短信限制
4085	同一手機號驗證碼短信發(fā)送超出【5】條

請求示例：

http://106.ihuyi.com/webservice/sms.php?method=Submit&account=APIID&password=APIKEY&mobile=手機號碼&content=您的驗證碼是:1234。請不要把驗證碼泄露給其他人。

發(fā)送成功，手機可收到短信。

如遇到提交異常時，可使用官方提供的在線調試工具。

短信接口除了提交短信能力外，還提供號碼黑名單、日發(fā)送量限制等能力。

如發(fā)送中遇到問題，可聯(lián)系在線客服，電話：4008808898。

7、短信項目上線

在官網進行認證賬號。

購買驗證碼通知短信套餐

添加短信驗證碼通知模板，審核成功后即可使用個性化模板發(fā)送。

設置自定義簽名，支持使用公司、APP應用、網站、系統(tǒng)名稱。