Cell Phone Number Service：本機號碼認證流程

第一步：服務端請求--擷取認證URL （POP）

調用GetPhoneNumberIdentificationUrl - 擷取本機號碼認證URL介面，擷取本機號碼認證URL。實現認證預檢 -> 建立認證會話 -> 返回認證地址的過程。

• 請求參數：

  • Ip：必填，使用者IP。需填寫使用者在蜂窩移動網路下出公網IP。

  • PhoneNumber：必填，使用者需要認證的手機號。

  • OutId：必填，外部系統ID，注意同一次認證流程中OutId需要保持一致。

  • AuthCode：必填，授權碼。

  • RememberPhoneNumber：是否記錄手機號，預設為true。

• 返回參數：

  • SessionId：會話 ID。

  • IdentificationUrl：認證 URL。

• 錯誤碼：

  IdentificationNotAvailable：該手機號或IP不支援認證（不計費）。

• 調用成功Demo：

  {
    "RequestId": "E62823DB-749B-16DD-8BBA-A5EEC1DE7C7C",
    "Message": "OK",
    "Data": {
      "IdentificationUrl": "https://global-ip-auth.dycpaas.com/global/biz/ip_auth/start?ipa_s_c_c=IPF0000000000000000001&ipa_s_i=f80623095e9aa807151032af385a7173.66344ead-9fd0-4f66-80d2-c86fc22d9178.c9be5054d7e9428590da0afd712ef17c.1685504264240&ipa_o_i=66344ead-9fd0-4f66-80d2-c86fc22d9178&ipa_p_n=62088991133003&ipa_r_u=https%3A%2F%2Fglobal-ip-auth.dycpaas.com%2Fglobal%2Fbiz%2Fip_auth%2Ffinish%3Fipa_s_i%3Df80623095e9aa807151032af385a7173.66344ead-9fd0-4f66-80d2-c86fc22d9178.c9be5054d7e9428590da0afd712ef17c.1685504264240%26ipa_o_i%3D66344ead-9fd0-4f66-80d2-c86fc22d9178",
      "SessionId": "f80623095e9aa807151032af385a7173.66344ead-9fd0-4f66-80d2-c86fc22d9178.c9be5054d7e9428590da0afd712ef17c.1685504264240"
    },
    "Code": "OK"
  }

第二步：用戶端請求--identificationUrl（HTTP）

使用者終端認證操作，必須從蜂窩資料網路發起，直接請求第一步：服務端請求--擷取認證URL （POP）中返回的認證地址。

本介面是HTTP介面，傳回值response（包含session_id、session_payload、out_id、success和message）大小寫和POP介面有所區別，請您留意。

{
  "session_payload": "EPj1vz1a3K51dvIolwRIuNwxrHuUsuaM/pl7PqGMnFblAzKIqJEagGTV5JsNB/3LkLuOl53NV63TUUsIDJ6G68W39bF39q/VGlszVboQnitFoV+kfZ1B/nydwrWhk7peSsKm1SaFDGmyUyyW27vx7cKW67vLB4LfWVZErDEngHteoxKqCQT6+hCFCw/MboqrfNOsWK0MnUx++xL4sH7421J9FcBXtEwDt6j9qmEcGWwOXYL9M4IkpMIsGOzakJqEAIoHX2DWDtOV8xTTvTDsergdEmKEYjvutqdZmwrkomHdb/6OeZM7wrexls2GdhMxxgmSpib7q7zMBUEbMUz+T+pTCYK0duLeRYD8ePG34oF/bq8jQi7hR4K2okfxAc36gL7ntrgSrdeUkNgPqEJ0/q6e3FioCxz4lyqxi0zjFz5Tyn9k5WIYV7GjDt5Mv4oW0ZPXW4QUUur7fp73ydhq7oFBK5webPwMdrqVPH10UzvuRH5P3Y8buV8WK75vaRXOIvgWBLEyypeuwGCVcGJ3X84iP+RKN2wCB0ggnlAm5kG+tlZ88Ly9lg==",
  "success": true,
  "session_id": "fb6cf28b819808b8437b37c1d77c73e4.out.1233.d6655b6c055f44cc8d897bc3583806e8.1683880287678",
  "out_id": "hwding",
  "message": "ok"
}

{
  "success": false,
  "session_id": "fb6cf28b819808b8437b37c1d77c734.out.1233.d6655b6c055f44cc8d897bc3583806e8.1683880287678",
  "out_id": "hwding",
  "message": "Invalid or expired session.",
  "code": "SessionNotValid"
}

第三步：服務端請求--擷取認證結果（POP）

調用GetPhoneNumberIdentificationResult - 擷取本機號碼認證結果介面，擷取本機號碼認證結果。

• 請求參數：

  • SessionId：必填，會話ID。

  • SessionPayload：必填，使用第二步：用戶端請求--identificationUrl（HTTP）中返回給用戶端的值

  • PhoneNumber：必填，使用者需要認證的手機號。

  • OutId：必填，外部系統ID，注意同一次認證流程中OutId需要保持一致。

  • AuthCode：必填，授權碼。

• 返回參數：

  IsIdentified，是否認證通過

• 錯誤碼：

  • NoIdentificationResult：無認證結果。

  • SessionNotValid：無效或到期的會話。

• 調用成功Demo：

  {
    "RequestId": "5C1DE9E0-8EA9-171B-9893-3E2881D981C9",
    "Message": "OK",
    "Data": {
      "IsIdentified": true
    },
    "Code": "OK"
  }