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

ruby對(duì)接短信服務(wù)開發(fā)教程

1、免費(fèi)注冊(cè)短信賬號(hào)

互億無(wú)線短信平臺(tái)會(huì)員免費(fèi)注冊(cè)(平臺(tái)將自動(dòng)免費(fèi)向每位會(huì)員贈(zèng)送測(cè)試短信)

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

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

3、查看短信API接口文檔

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

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

4、查看短信DEMO示例

各種開發(fā)語(yǔ)言無(wú)障礙接入。

5、下載短信插件

使用平臺(tái)提供的短信插件，可以快速接入短信發(fā)送功能。

6、短信接口提交測(cè)試

在頁(yè)面中查找專屬的APIID和APIKEY；

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

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

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

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

響應(yīng)示例：

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

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

請(qǐng)求示例：

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

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

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

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

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

7、短信項(xiàng)目上線

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

購(gòu)買驗(yàn)證碼通知短信套餐

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

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