自從微信小程序提供云開發(fā)支持官扣,開發(fā)者無需搭建后臺服務器翅敌,使用微信提供的核心API就可以實現(xiàn)應用功能,此時就需要小程序能夠自己發(fā)送短信惕蹄,比如短信驗證碼蚯涮,榛子云短信(http://smsow.zhenzikj.com)為此開發(fā)了一套專門用于小城的SDK,詳情參考: http://smsow.zhenzikj.com/doc/sdk.html
下面小編就詳細講解一下如何使用:?
1.安裝
下載后的SDK只包含一個zhenzisms.js文件,可直接放在utils文件夾中卖陵,然后通過require引入遭顶,如下:
var?zhenzisms?=?require('../../utils/zhenzisms.js');
2.配置域名
在微信公眾平臺-小程序管理中配置域名https://smsdeveloper.zhenzikj.com,如下圖:
使用事先申請的AppId、AppSecret初始化:
zhenzisms.client.init(apiUrl,?appId,?appSecret);
apiUrl為請求地址赶促,個人開發(fā)者使用https://sms_developer.zhenzikj.com液肌,企業(yè)開發(fā)者使用https://sms.zhenzikj.com
zhenzisms.client.send(function(res){
????????????????console.log(res.data);
??????????????})
?????????????},?'15811111111',?'您的驗證碼為2323');
send方法用于單條發(fā)送短信
參數(shù)1:請求后的用于接收返回結(jié)果的回調(diào)函數(shù),參數(shù)2:接收者手機號碼鸥滨,參數(shù)3:短信內(nèi)容
返回結(jié)果是json格式的字符串, code: 發(fā)送狀態(tài),0為成功谤祖。非0為發(fā)送失敗婿滓,可從data中查看錯誤信息
注: 測試發(fā)送短信內(nèi)容不要使用"你好"或"12132"全數(shù)字形式,這種短信內(nèi)容沒有具體的意義粥喜,可能會被運營商屏蔽
{
????"code":0,
????"data":"發(fā)送成功"
}
2)發(fā)送短信(返回狀態(tài)報告)
zhenzisms.client.send(function(res){
????????????????console.log(res.data);
??????????????})
?????????????},?'15811111111',?'您的驗證碼為2323',?'dfee_dfdw_xdfd_dfdfd');
send方法用于單條發(fā)送短信,并且開發(fā)者可接受短信發(fā)送狀態(tài)報告凸主,具體使用請參考:API說明
參數(shù)1:請求后的用于接收返回結(jié)果的回調(diào)函數(shù),參數(shù)2:接收者手機號碼额湘,參數(shù)3:短信內(nèi)容, 參數(shù)4:messageId即該條短信的唯一標識, 不能重復
返回結(jié)果是json格式的字符串, code: 發(fā)送狀態(tài)卿吐,0為成功。非0為發(fā)送失敗锋华,可從data中查看錯誤信息
錯誤代碼表
錯誤碼 原因 解決方案
100 參數(shù)格式錯誤 檢查請求參數(shù)是否為空, 或手機號碼格式錯誤
101 短信內(nèi)容超過1000字 短信內(nèi)容過長嗡官,請篩檢或分多次發(fā)送
105 appId錯誤或應用不存在 請聯(lián)系工作人員申請應用或檢查appId是否輸入錯誤
106 應用被禁止 請聯(lián)系工作人員查看原因
107 ip錯誤 如果設置了ip白名單,系統(tǒng)會檢查請求服務器的ip地址毯焕,已確定是否為安全的來源訪問
108 短信余額不足 需要到用戶中心進行充值
109 今日發(fā)送超過限額 如果設置了日發(fā)送數(shù)量衍腥,則每個接收號碼不得超過這個數(shù)量
110 應用秘鑰(AppSecret)錯誤 檢查AppSecret是否輸入錯誤,或是否已在用戶中心進行了秘鑰重置
111 賬號不存在 請聯(lián)系工作人員申請賬號
1000 系統(tǒng)位置錯誤 請聯(lián)系工作人員或技術人員檢查原因
3)查看余額
通過該接口可查看當前剩余的短信條數(shù)
zhenzisms.client.balance(function(res){
???????????????console.log(res.data)
????????????});
返回結(jié)果是json格式的字符串, code: 查詢狀態(tài),0為成功婆咸,data為剩余短信條數(shù)竹捉。非0為查詢失敗,可從data中查看錯誤信息
錯誤代碼表
錯誤碼 原因 解決方案
100 參數(shù)格式錯誤 檢查請求參數(shù)是否為空
105 appId錯誤或應用不存在 請聯(lián)系工作人員申請應用或檢查appId是否輸入錯誤
106 應用被禁止 請聯(lián)系工作人員查看原因
107 ip錯誤 如果設置了ip白名單尚骄,系統(tǒng)會檢查請求服務器的ip地址块差,已確定是否為安全的來源訪問
110 應用秘鑰(AppSecret)錯誤 檢查AppSecret是否輸入錯誤,或是否已在用戶中心進行了秘鑰重置
1000 系統(tǒng)位置錯誤 請聯(lián)系工作人員或技術人員檢查原因
4)查詢短信
接口描述
根據(jù)messageId查詢已發(fā)送短信
zhenzisms.client.findSmsByMessageId(function(res){
???????????????console.log(res.data)
????????????},?'dfee_dfdw_xdfd_dfdfd');
請求參數(shù)
參數(shù)名稱 必選 類型 描述
messageId 是 string 信息id,對應發(fā)送短信接口的messageId字段
返回結(jié)果
返回結(jié)果是json格式的字符串, code: 查詢狀態(tài),0為成功闸餐。非0為失敗惭适,可從data中查看錯誤信息
{
????"code":0,
????"data":{}
}
返回結(jié)果是json格式的字符串, code: 查詢狀態(tài),0為成功班巩,data短信信息的json字符串
原文: http://smsow.zhenzikj.com/news/detail/284.html