什麼是騰訊驗證碼?它長這個樣子……👇html
最近公司項目要求引入騰訊雲驗證,要求是這樣的:爲了防止別人惡意刷短信驗證碼,當用戶短期內屢次獲取驗證碼的時候,須要調用騰訊驗證碼,驗證成功後會繼續自動發送驗證碼,剛開始的我聽的一臉矇蔽,網上搜索也沒有多少相關的文章,然而如今我接通啦,發現是很簡單點事(或許就是由於太簡單了因此沒有人寫2333…)前端
很少BB,開始吧!vue
先看文檔的接口調用流程:web
(文檔地址:cloud.tencent.com/document/pr…)json
總共分紅幾個小步驟:promise
後臺的事不去管它,那咱們前端都須要作什麼呢?瀏覽器
首先在須要引入騰訊驗證碼的.vue組件內加入一個標籤👇:bash
<div id="TCaptcha" style="width:300px;height:40px;" ></div>複製代碼
而後當你頻繁屢次調用發送短信的接口,直到觸發了須要調用騰訊驗證碼時(這個判斷是後臺告訴你的,好比咱們項目中接口傳參的JSON中有個isShow的變量,若是等於1則要觸發騰訊雲驗證了,默認狀態下是0,就是不須要騰訊驗證。具體狀況問大家的後臺去,手動滑稽)函數
上圖是咱們項目中實際的接口回調,能夠看到回調中有個Js地址和businessId;ui
這個Js地址就是你去獲取雲驗證的方式,你須要寫一個方法,把這個Js動態添加到body標籤內👇:
參數src是調用獲取驗證碼接口返回數據時,將Js地址傳過來。
capInit這個函數是當你將Js引入進去後纔會有的,不然報錯,因此設置一個延遲(代碼比較簡陋,能夠用promise)。
而後這個callback回調函數就是用戶驗證以後,會調用該函數,傳入json格式驗證參數。👇
//回調函數:驗證碼頁面關閉時回調
cbfn(res) {
if (res.ret == 0) {
// 用戶驗證成功,獲取到ticket,而後你須要將這個ticket和以前的businessId一塊兒傳給後臺
// 若後臺驗證成功,用戶就能夠收到驗證碼了,無需你再作其餘操做
alert(res.ticket);
capDestroy()
}
else {
//用戶關閉驗證碼頁面,沒有驗證
capDestroy() //銷燬以前建立的script標籤
}
}複製代碼
重複一遍:用戶驗證成功,獲取到ticket,而後你須要將這個ticket和以前的businessId一塊兒傳給後臺。若後臺驗證成功,用戶就能夠收到驗證碼了,無需你再作其餘操做
最後再說(複製)一下capInit(iframe_div, options)這個函數,options是一個Json對象,能夠設置多個參數。👇
1. iframe_div(必填):嵌入驗證碼 iframe 的元素。
2. options: {callback:xxx,showheader:xxx, themeColor:xxxxxx,type:"embed"},json 格式對象
callback: 驗證碼頁面關閉回調函數。用戶驗證以後,會調用該函數,傳入json格式驗證參數。{ret:xxx,ticket:"xxx"}themeColor:設置頁面的主題色彩,值爲 16 進制色彩,好比 ff572d。設置後頁面裏的按鈕和圖標會變成設置的顏色
ret=0 表示用戶驗證完成,業務能夠校驗 ticket;
ret=1 表示用戶未驗證驗證碼,此時沒有 ticket 參數。
參數 ticket 須要提交給業務後臺,具體填哪一個字段參考後面後臺 server 開發部分。
showHeader:顯示驗證碼頁面的 header (返回和幫助,只對手機頁面有效)false:不顯示type:PC 端可選選項,配置驗證碼的樣式。具體樣式表現能夠查看 驗證碼官網
"point":觸發式(默認)pos:設置彈框驗證碼的位置屬性,該參數只對 PC 彈框驗證碼有效
"embed":嵌入式
"popup":彈窗式absolute: 絕對定位keepOpen:設置驗證經過頁面屬性
fixed:相對於瀏覽器窗口的絕對定位
static:靜態定位
relative:相對定位
false:驗證經過刷新(默認)lang:設置驗證碼語言類型
true:保持顯示,不刷新
簡體中文:2052(默認)
繁體中文:1028
英文:1033
要記得及時調用capDestroy()來銷燬你建立的script標籤,不然就會出現不少個script標籤……
文檔上說的是在調用capInit()以前調用capDestroy(),可是我試了一下,很差使,最後放在了回調裏,不管驗證成功仍是用戶沒有驗證,關閉了驗證彈窗,都調用一下capDestroy()。
騰訊驗證碼PC網頁API地址:cloud.tencent.com/document/pr…
若是有問題,或者哪裏說的不對,歡迎留言討論~~