登錄流程
獲取二維碼->app掃描二維碼->點(diǎn)擊確認(rèn)登錄->登錄成功
接口說明:
1. 獲取二維碼code圖片(PC調(diào)用)
獲取二維碼code圖片
-
參數(shù):
qrSize 二維碼大小 最大512 默認(rèn) 94 logoSize logo大小 最大256 默認(rèn)32 logo logo編號 如需定制請聯(lián)系開發(fā)者 返回:image數(shù)據(jù)流
異常:errorCode:-1 系統(tǒng)異常
使用場景:頁面加載二維碼時(shí),調(diào)用此接口獲取二維碼圖片。
示例:<img src="https://xxx.xxx.com/qr/loginpic/?qrSize=513&logo=2"></img>
2.獲取二維碼code(PC調(diào)用)
獲取二維碼code
參數(shù):無
返回:code 二維碼內(nèi)容加密信息
異常:errorCode:-1 系統(tǒng)異常
使用場景:頁面加載二維碼時(shí),調(diào)用此接口獲取二維碼內(nèi)容,并將code轉(zhuǎn)換成二維碼圖片展示到頁面。
3.請求登錄****(PC調(diào)用)
請求登錄接口
參數(shù):*無
-
返回:
statusflag:0 此時(shí)二維碼處于待掃描狀態(tài) statusflag:1 此時(shí)二維碼處于已掃描狀態(tài) statusflag:2 登錄成功;url:跳轉(zhuǎn)頁面 statusflag:-2 二維碼失效 statusflag:-1 錯(cuò)誤 (包括運(yùn)行時(shí)異常和鑒權(quán)) 異常:errorCode:-1 系統(tǒng)異常
使用場景:頁面加載二維碼后,輪詢調(diào)用此接口,查詢二維碼此時(shí)狀態(tài),根據(jù)不同狀態(tài)進(jìn)行不同的頁面展現(xiàn)和處理。建議2~3秒調(diào)用一次,不允許間隔時(shí)間太短,防止被封殺
-
頁面處理:
statusflag:0 繼續(xù)輪詢登錄接口 statusflag:1 遮蓋二維碼;提示用戶“二維碼已被掃描,請?jiān)赼pp點(diǎn)擊確認(rèn)登錄”;繼續(xù)輪詢登錄接口 statusflag:2 停止輪詢登錄接口;跳轉(zhuǎn)到接口返回的url;增加擴(kuò)展字段ext,內(nèi)容為app端在lockcode時(shí)埋入的內(nèi)容 statusflag:-2 遮蓋二維碼;提示用戶“二維碼已失效,請重新獲取”;停止輪詢登錄接口 statusflag:-1 建議與二維碼失效同樣處理
4. app激活二維碼****(APP調(diào)用)
app鎖定二維碼接口
參數(shù):String code 從二維碼圖片中掃面出的信息;String ext 擴(kuò)展字段(可空)
-
返回:
statusflag:0 成功 ;type:二維碼類型 statusflag:-2 二維碼失效 statusflag:-1 錯(cuò)誤 (包括運(yùn)行時(shí)異常和鑒權(quán)) 異常:*errorCode:-1 系統(tǒng)異常
使用場景:app掃描二維碼后,從二維碼中獲取code值,調(diào)用此接口,使二維碼綁定app。
5. app激活二維碼****(APP調(diào)用)
app激活二維碼接口
參數(shù):String code 從二維碼圖片中掃面出的信息
-
返回:
statusflag:0 成功 statusflag:-2 二維碼失效 statusflag:-1 錯(cuò)誤 (包括運(yùn)行時(shí)異常和鑒權(quán)) 異常:errorCode:-1 系統(tǒng)異常
使用場景:app鎖定二維碼成功后,用戶點(diǎn)擊確認(rèn)后,調(diào)用此接口,允許pc登錄成功。
6.app取消操作****(APP調(diào)用)
app取消操作
參數(shù):String code 從二維碼圖片中掃面出的信息
-
返回:
statusflag:0 成功 statusflag:-2 二維碼失效 statusflag:-1 錯(cuò)誤 (包括運(yùn)行時(shí)異常和鑒權(quán)) 異常:*errorCode:-1 系統(tǒng)異常
使用場景:app鎖定二維碼成功后,用戶點(diǎn)擊取消后,調(diào)用此接口,使二維碼過期。
