本文介紹了短信發(fā)送功能的實現(xiàn)，通過該文章，用戶可以為自己的網(wǎng)站、App、小程序等快速接入短信發(fā)送功能。支持發(fā)送驗證、通知及營銷類短信內(nèi)容。適用于用戶注冊、會員登錄、找回密碼、訂單通知場景。短信可發(fā)送至移動、聯(lián)通、電信運營商手機號碼。

ruby調(diào)用短信接口開發(fā)教程

1、免費注冊短信賬號

免費注冊互億無線短信平臺會員（平臺會自動免費給每個會員贈送測試短信）

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

短信實現(xiàn)流程說明

3、查看短信API接口文檔

登錄互億無線短信平臺可以查看短信發(fā)送功能使用向?qū)В榭碅PI接口文檔。

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

4、查看短信DEMO示例

提供完整的DEMO示例方便開發(fā)者接入，提供多種開發(fā)語言，如JAVA、PHP、Python、C++等。

5、下載短信插件

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

6、短信接口提交測試

在接口請求參數(shù)中找到自己的APIID和APIkey；

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

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

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

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

響應(yīng)示例：

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

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

請求示例：

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

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

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

短信接口除了提交短信能力外，還提供余額查詢、發(fā)送回執(zhí)推送等能力。

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

7、驗證碼通知短信開通流程

已封裝的成熟的短信接口，讓可以在15分鐘內(nèi)完成驗證碼通知接口的接入。