本文介紹了短信發(fā)送功能的實(shí)現(xiàn),通過該文章,用戶可以為自己的網(wǎng)站、App、小程序等快速接入短信發(fā)送功能。支持發(fā)送驗(yàn)證、通知及營銷類短信內(nèi)容。適用于用戶注冊、會員登錄、找回密碼、訂單通知場景。短信可發(fā)送至移動(dòng)、聯(lián)通、電信運(yùn)營商手機(jī)號碼。
java短信驗(yàn)證碼設(shè)計(jì)開發(fā)教程
1、免費(fèi)注冊短信賬號
免費(fèi)注冊互億無線短信平臺會員(平臺會自動(dòng)免費(fèi)給每個(gè)會員贈(zèng)送測試短信)
2、短信發(fā)送邏輯
短信業(yè)務(wù)流程說明
3、查看短信API接口文檔
登錄互億無線短信平臺可以查看短信發(fā)送功能使用向?qū)В榭碅PI接口文檔。
接口說明:
1、接口功能:支持短信發(fā)送、回執(zhí)推送、余額查詢、上行回復(fù)推送;
2、提交方式:GET/POST;
3、加密方式:
? 采用HTTPS協(xié)議提交請求
? 通過MD5動(dòng)態(tài)簽名方式加密
4、短信模板:測試期間,須使用系統(tǒng)默認(rèn)的模板進(jìn)行測試,默認(rèn)模板內(nèi)容:您的驗(yàn)證碼是:1234。請不要把驗(yàn)證碼泄露給其他人。
5、短信簽名:調(diào)試期間,須使用系統(tǒng)默認(rèn)簽名【互億無線】
4、查看短信DEMO示例
輕松對接,支持各種主流語言。
5、下載短信插件
提供各類系統(tǒng)的短信插件,無需開發(fā)即可接入短信功能。
6、短信接口提交測試
在接口請求參數(shù)中找到自己的APIID和APIkey;
通過POST、 GET 方式進(jìn)行短信提交,數(shù)據(jù)編碼采用utf-8格式,請求地址為:https://106.ihuyi.com/webservice/sms.php?method=Submit。請求參數(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)密碼方式請看該文檔末尾的說明) |
是 |
mobile |
接收手機(jī)號碼,只能提交1個(gè)號碼 |
是 |
content |
短信內(nèi)容(編碼格式為 UTF-8,支持 300 個(gè)字的長短信,長短信 按多條計(jì)費(fèi))
例如:您的驗(yàn)證碼是:1234。請不要把驗(yàn)證碼泄露給其他人。 |
是 |
time |
Unix時(shí)間戳(10位整型數(shù)字,當(dāng)使用動(dòng)態(tài)密碼方式時(shí)為必填) |
否 |
format |
返回格式(可選值為:xml或json,系統(tǒng)默認(rèn)為xml) |
否 |
用戶通過http 或 https提交發(fā)送短信請求到服務(wù)器后,服務(wù)器會返回一串xml格式的字符串,SubmitResult結(jié)構(gòu)說明如下:
參數(shù)名稱 |
類型 |
描述 |
code |
int |
返回值為2時(shí),表示提交成功 |
smsid |
string |
當(dāng)提交成功后,此字段為流水號,否則為0 |
msg |
string |
提交結(jié)果描述 |
響應(yīng)示例:
運(yùn)行函數(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 |
動(dòng)態(tài)密碼已過期 |
40502 |
動(dòng)態(tài)密碼校驗(yàn)失敗 |
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ī)號驗(yàn)證碼短信發(fā)送超出【5】條 |
請求示例:
http://106.ihuyi.com/webservice/sms.php?method=Submit&account=APIID&password=APIKEY&mobile=手機(jī)號碼&content=您的驗(yàn)證碼是:1234。請不要把驗(yàn)證碼泄露給其他人。
發(fā)送成功,手機(jī)可收到短信。
如遇到提交異常時(shí),可使用官方提供的在線調(diào)試工具。
短信接口除了提交短信能力外,還提供請求IP限制、數(shù)據(jù)推送等能力。
如發(fā)送中遇到問題,可聯(lián)系在線客服,電話:4008808898。
7、短信項(xiàng)目上線
在官網(wǎng)進(jìn)行企業(yè)、個(gè)人實(shí)名認(rèn)證。
購買短信驗(yàn)證碼通知套餐
添加驗(yàn)證碼短信、通知短信模板,審核后即可使用自定義短信模板發(fā)送。
設(shè)置個(gè)性化簽名,支持使用企業(yè)、機(jī)構(gòu)、網(wǎng)站應(yīng)用名稱。