号码百科：本机号码认证流程

第一步：服务端请求--获取认证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"
  }