開始集成

支持兩種集成網頁端SDK的方法，您可任選其中一種：

• 靜態資源引入。

  將網頁端SDK上傳到您的靜態資源服務器上，獲取能夠訪問到網頁端SDK的URL，通過script標簽的方式引入。

  <script type="text/javascript" charset="utf-8" src="${your-sdk-asset-path}/numberAuth-web-sdk.js"></script>

• npm包引入。下載npm資源，將aliyun_numberauthsdk_web包添加為項目依賴。

  // 下載npm資源并添加依賴到package.json
  npm i aliyun_numberauthsdk_web -S

初始化實例

const phoneNumberServer = new PhoneNumberServer();

checkAuthAvailable（本機號碼校驗鑒權接口）

調用該接口之前，請在服務端調用GetAuthToken接口，獲取本機號碼校驗鑒權接口所需的accessToken和jwtToken。

方法參數

success/error回調函數入參

調用示例

// 調用之前先去用戶服務端獲取AccessToken和JwtToken
phoneNumberServer.checkAuthAvailable({
  accessToken: "XXXXXXXXXX",
  jwtToken: "******",
  success: function (res) {
    console.log(res);
    if (res.code === 600000) {
      // 在此調用getVerifyToken接口
    }
  },

  error: function (res) {
    // 提示用戶關閉Wi-Fi或者嘗試其他登錄方案
  },
});

getVerifyToken（獲取本機號碼校驗Token接口）

在checkAuthAvailable成功回調中調用此接口。

方法參數

success/error回調函數入參

調用示例

phoneNumberServer.getVerifyToken({
  success: function (res) {
    console.log(res);
    // 獲取到用戶輸入的手機號+spToken校驗本機號碼
  },

  error: function (res) {},
});

getVersion（獲取SDK版本號）

const phoneNumberServer = new PhoneNumberServer();
const sdkVersion = phoneNumberServer.getVersion();  // 返回SDK版本號 eg: '1.0.0' 

getConnection（網絡類型檢查接口）

網絡類型檢查接口，您可自行選擇是否調用，對認證流程無阻礙。

• 此接口會判斷當前用戶的網絡類型： Wi-Fi（wifi）、移動數據網絡（cellular）、unknown。

  重要

  未開啟移動數據網絡的用戶無法通過一鍵登錄完成認證。

• 提前獲取用戶的網絡類型，攔截使用Wi-Fi網絡的用戶，及時終止認證流程，節約資源并提升用戶的認證體驗。

• 建議認證前調用此接口，對netType為wifi的用戶提醒關閉Wi-Fi或者提供其他認證方式，對于netType為unknown和cellular的用戶繼續一鍵登錄流程。

const phoneNumberServer = new PhoneNumberServer();
const netType =  phoneNumberServer.getConnection();
// console.log(netType);
// netType的值為wifi(Wi-Fi)、cellular（流量）、unknown（未知）

sendLoggerEnable（設置開啟日志）

isEnable：是否開啟，true為開啟，false為不開啟。

const phoneNumberServer = new PhoneNumberServer();
phoneNumberServer.setLoggerEnable(true);