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

ruby對接短信平臺開發(fā)教程

1、免費注冊短信賬號

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

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

短信業(yè)務流程說明

3、查看短信API接口文檔

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

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

4、查看短信DEMO示例

支持多種語言 SDK 和 API 接口接入。

5、下載短信插件

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

6、短信接口提交測試

在頁面中查找專屬的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ā)送短信請求到服務器后，服務器會返回一串xml格式的字符串，SubmitResult結(jié)構(gòu)說明如下：

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

響應示例：

運行函數(shù)后，查看接口的提交狀態(tài)，確保接口請求提交是成功的，如果不成功，可根據(jù)接口返回的狀態(tài)，查到對應的原因，根據(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ā)送量限制等能力。

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

7、短信項目上線

在官網(wǎng)進行企業(yè)個人認證。

購買短信套餐

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

設置個性化簽名，支持使用企業(yè)、機構(gòu)、網(wǎng)站應用名稱。