java + maven 實現發送短信驗證碼功能

如何使用java + maven的項目環境發送短信驗證碼，本文使用的是榛子云短信 的接口。

1. 安裝sdk

下載地址: http://smsow.zhenzikj.com/doc/sdk.html

下載下來是jar文件，需要將jar發佈到本地的maven倉庫中， 在cmd環境下輸入:

mvn install:install-file -DgroupId=com.zhenzi -DartifactId=sms -Dversion=1.0.0 -Dpackaging=jar -Dfile=/Users/Downloads/ZhenziSmsSDK.jar

注意:-Dfile是你本地下載的jar文件的路徑，本例中使用的mac系統

接下來在pom.xml中引入項目:

<dependency>
	 <groupId>com.zhenzi</groupId>
	 <artifactId>sms</artifactId>
	 <version>1.0.0</version>
</dependency>

ok， sdk安裝完畢，其實也挺簡單的

 

2. 申請測試賬號，獲取appId、appSecret

測試賬號需要人工申請，一般幾分鐘就可以申請下來。

使用測試賬號登錄管理後臺獲取appId、appSecret, 地址: http://sms.zhenzikj.com/zhenzisms_user

 

在"我的應用"->"詳情"中打開:

3.用法

使用事先申請的AppId、AppSecret初始化ZhenziSmsClient:

ZhenziSmsClient client = new ZhenziSmsClient(appId, appSecret);

AppId、AppSecret是短信平臺分配的

1)發送短信

String result = client.send("15811111111", "您的驗證碼爲4534，有效時間爲5分鐘");

send方法用於單條發送短信

參數1:接收者手機號碼，參數2:短信內容

返回結果是json格式的字符串, code: 發送狀態，0爲成功。非0爲發送失敗，可從data中查看錯誤信息

			{
			    "code":0,
			    "data":"發送成功"
			}

錯誤代碼表

錯誤碼	原因	解決方案
100	參數格式錯誤	檢查請求參數是否爲空, 或手機號碼格式錯誤
101	短信內容超過1000字	短信內容過長，請篩檢或分多次發送
105	appId錯誤或應用不存在	請聯繫工作人員申請應用或檢查appId是否輸入錯誤
106	應用被禁止	請聯繫工作人員查看原因
107	ip錯誤	如果設置了ip白名單，系統會檢查請求服務器的ip地址，已確定是否爲安全的來源訪問
108	短信餘額不足	需要到用戶中心進行充值
109	今日發送超過限額	如果設置了日發送數量，則每個接收號碼不得超過這個數量
110	應用祕鑰(AppSecret)錯誤	檢查AppSecret是否輸入錯誤，或是否已在用戶中心進行了祕鑰重置
111	賬號不存在	請聯繫工作人員申請賬號
1000	系統位置錯誤	請聯繫工作人員或技術人員檢查原因