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

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

1、免費注冊短信賬號

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

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

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

3、查看短信API接口文檔

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

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

4、查看短信DEMO示例

提供http(s)協(xié)議短信API。

5、下載短信插件

提供各開源系統(tǒng)短信插件，免開發(fā)快速接入短信功能。

6、短信接口提交測試

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

通過POST、 GET 方式進(jìn)行短信提交，數(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	接收手機(jī)號碼，只能提交1個號碼	是
content	短信內(nèi)容(編碼格式為 UTF-8，支持 300 個字的長短信，長短信 按多條計費) 例如:您的驗證碼是:1234。請不要把驗證碼泄露給其他人。	是
time	Unix時間戳（10位整型數(shù)字，當(dāng)使用動態(tài)密碼方式時為必填）	否
format	返回格式（可選值為：xml或json，系統(tǒng)默認(rèn)為xml）	否

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

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

響應(yīng)示例：

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

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

請求示例：

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

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

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

短信接口除了提交短信能力外，還提供請求IP限制、數(shù)據(jù)推送等能力。

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

7、短信項目上線

在官網(wǎng)進(jìn)行企業(yè)、個人實名認(rèn)證。

購買驗證碼通知短信套餐

添加驗證碼通知短信模板，審核通過后即可使用自定義短信模板發(fā)送。

設(shè)置簽名，支持使用公司、APP、網(wǎng)站、小程序名稱。