H5端接口文档

本文档为您提供了H5端的实名认证接口文档，您可以基于此接口进行业务信息的二次开发及查询操作。

获取Token

1、获取verify_token接口

本接口为H5实名认证方案的verify_token获取接口，verify_token的有效期为2小时

调用方式

请求URL数据格式

向API服务地址使用POST发送请求，必须在URL中带上参数access_token，可通过后台的API Key和Secret Key生成，具体方式请参考“Access Token获取”。

注意：access_token的有效期为30天，切记需要每30天进行定期更换，或者每次请求都拉取新token；

POST中Body的参数，按照下方请求参数说明选择即可。

提示：如果您为百度云老用户，正在使用其他非AI的服务，可以参考百度云AKSK鉴权方式发送请求，虽然请求方式和鉴权方法和本文所介绍的不同，但请求参数和返回结果一致。

请求说明

注意事项：

• 请求体格式化：Content-Type为application/json，通过json格式化请求体。

请求示例

HTTP方法：POST

请求URL： https://aip.baidubce.com/rpc/2.0/brain/solution/faceprint/verifyToken/generate

URL参数：

Header：

Body中放置请求参数，参数详情如下：

请求参数：

请求示例：

{
	"plan_id" : 1
}

返回参数

• 返回结果

• 返回示例

  {
      "success": true,
      "result": {
          "verify_token": "Yz9rWITm4vak16PBAh5x8oG7"
      },
      "log_id": "1814798895"
  }

指定用户信息上报接口

本接口用于，前端在方案中选择身份信息录入-身份信息录入方式-指定用户身份核验时，需要先调用此接口输入指定用户的姓名+身份证号信息，再请求url跳转页面。

调用方式

请求URL数据格式

向API服务地址使用POST发送请求，必须在URL中带上参数access_token，可通过后台的API Key和Secret Key生成，具体方式请参考“Access Token获取”。

注意：access_token的有效期为30天，切记需要每30天进行定期更换，或者每次请求都拉取新token；

POST中Body的参数，按照下方请求参数说明选择即可。

提示：如果您为百度云老用户，正在使用其他非AI的服务，可以参考百度云AKSK鉴权方式发送请求，虽然请求方式和鉴权方法和本文所介绍的不同，但请求参数和返回结果一致。

请求说明

注意事项：

• 请求体格式化：Content-Type为application/json，通过json格式化请求体。

请求示例

HTTP方法：POST

请求URL：https://brain.baidu.com/solution/faceprint/idcard/submit

注意这里不需要传access_token

Header：

Body中放置请求参数，参数详情如下：

请求示例：

{
    "verify_token": "2sF3nE5mXOHkx2aQwWG4n5WI",
    "id_name": "张三",
    "id_no": "500***********3390",
    "certificate_type": 0            // 证件类型：0大陆居民二代身份证，1港澳台居民来往内地通行证，2外国人永久居留证，3定居国外的中国公民护照
}

返回参数

• 返回结果

• 返回示例

  {
      "success": true,
      "result": 1,
      "log_id": "1244068892"
  }

验证后查询接口

获取Token后，请先按照跳转实名认证H5 URL，用户进行操作后再查询接口，否则生成Token无法生效。

1、获取认证人脸接口

本接口返回进行人脸实名认证过程中进行认证的最终采集的人脸信息。

调用方式

请求URL数据格式

向API服务地址使用POST发送请求，必须在URL中带上参数access_token，可通过后台的API Key和Secret Key生成，具体方式请参考“Access Token获取”。

注意：access_token的有效期为30天，切记需要每30天进行定期更换，或者每次请求都拉取新token；

POST中Body的参数，按照下方请求参数说明选择即可。

提示：如果您为百度云老用户，正在使用其他非AI的服务，可以参考百度云AKSK鉴权方式发送请求，虽然请求方式和鉴权方法和本文所介绍的不同，但请求参数和返回结果一致。

请求说明

注意事项：

• 请求体格式化：Content-Type为application/json，通过json格式化请求体。

请求示例

HTTP方法：POST

请求URL： https://aip.baidubce.com/rpc/2.0/brain/solution/faceprint/result/simple

URL参数：

Header：

Body中放置请求参数，参数详情如下：

请求示例：

{
	"verify_token" : "cIupeyP51sn28XzxGVTfYqoN"
}

返回参数

• 返回结果

• 返回示例

  {
      "success": true,
      "result": {
          "image":"https://brain.baidu.com/solution/faceprint/image/query?verify_token=xxxxxx"
      },
      "log_id": "1054986003"
  }

2、查询认证结果接口

本接口为请求返回的认证结果信息查询，包含身份证OCR识别信息、用户二次确认的身份证信息，活体检测信息、及用户对权威数据源图片进行比对的分数信息。

调用方式

请求URL数据格式

向API服务地址使用POST发送请求，必须在URL中带上参数access_token，可通过后台的API Key和Secret Key生成，具体方式请参考“Access Token获取”。

注意：access_token的有效期为30天，切记需要每30天进行定期更换，或者每次请求都拉取新token；

POST中Body的参数，按照下方请求参数说明选择即可。

提示：如果您为百度云老用户，正在使用其他非AI的服务，可以参考百度云AKSK鉴权方式发送请求，虽然请求方式和鉴权方法和本文所介绍的不同，但请求参数和返回结果一致。

请求说明

注意事项：

• 请求体格式化：Content-Type为application/json，通过json格式化请求体。

请求示例

HTTP方法：POST

请求URL： https://aip.baidubce.com/rpc/2.0/brain/solution/faceprint/result/detail

URL参数：

Header：

Body中放置请求参数，参数详情如下：

请求示例：

{
	"verify_token" : "cIupeyP51sn28XzxGVTfYqoN"
}

返回参数

• 返回结果

• 返回示例

  {
    "success": true,
    "result": {
        "verify_result": {
            "score": 93.7835,
            "liveness_score": 0.9672966,
            "spoofing": 0.0
        },
        "idcard_ocr_result": {
            "birthday": "19960216",
            "issue_authority": "胶南市公安局",
            "address": "山东省***********",
            "gender": "女",
            "nation": "汉",
            "expire_time": "20221103",
            "name": "柴*",
            "issue_time": "20121103",
            "id_card_number": "370***********5826"
        },
        "idcard_images": {
            "front_base64": "/9j/4AAQSkZJRgAB....",
            "back_base64": "/9j/4AAQSkZJRgAB...."
     },
        "idcard_confirm": {
            "idcard_number": "370***********5826",
            "name": "柴*"
        }
    },
    "log_id": "160931948204246"
  }

3、查询统计结果

根据Verify_token返回的结果信息会在云端保留三天，您可根据需要在此期间进行调取查询。

调用方式

请求URL数据格式

向API服务地址使用POST发送请求，必须在URL中带上参数access_token，可通过后台的API Key和Secret Key生成，具体方式请参考“Access Token获取”。

注意：access_token的有效期为30天，切记需要每30天进行定期更换，或者每次请求都拉取新token；

POST中Body的参数，按照下方请求参数说明选择即可。

提示：如果您为百度云老用户，正在使用其他非AI的服务，可以参考百度云AKSK鉴权方式发送请求，虽然请求方式和鉴权方法和本文所介绍的不同，但请求参数和返回结果一致。

请求说明

注意事项：

• 请求体格式化：Content-Type为application/json，通过json格式化请求体。

请求示例

HTTP方法：POST

请求URL： https://aip.baidubce.com/rpc/2.0/brain/solution/faceprint/result/stat

URL参数：

Header：

Body中放置请求参数，参数详情如下：

请求示例：

{
	"verify_token" : "cIupeyP51sn28XzxGVTfYqoN"
}

返回参数

• 返回结果

• 返回示例

  {
      "success": true,
      "result": {
          "身份证识别": [
              {
                  "error_code": 0,
                  "count": 2
              }
          ],
          "h5活体视频分析": [
              {
                  "error_code": 0,
                  "count": 1
              }
          ],
          "人脸实名认证-V3": [
              {
                  "error_code": 0,
                  "count": 1
              }
          ]
      },
      "log_id": "1405335905"
  }