资讯 社区 文档
技术能力
语音技术
文字识别
人脸与人体
图像技术
语言与知识
视频技术

接口文档

H5人脸实名认证方案提供多接口能力,实现以下功能:

  • 对比图片上传:上传用于1:1人脸比对的人脸底图,快速直达
  • 指定用户信息上报:上传用于权威数据源验证时的用户身份证号码、姓名,实现无需用户拍照或手动输入,直接进行活体及识别,快速直达
  • 获取认证人脸:获取认证成功最终采集的人脸信息,快速直达
  • 查询认证结果:获取身份证信息(仅在使用OCR的情况下返回)、活体检测分数、人脸相似度得分,快速直达
  • 实时方案视频获取:获取实时活体检测过程的视频/图片,快速直达
  • 核验及计费信息获取:获取对应verify_token下的所有核验信息(人脸、身份信息、认证结果),以及后端接口(人脸实名认证V4、人脸对比V4)的计费与否及计费时间, 快读直达

H5人脸实名认证方案的配套功能

  • 记录查询:如您希望获取方案的记录信息,可开通记录查询功能进行可视化查看。
  • 数据报警:通过简单设置,即可对接口的安全风险监控,为业务保驾护航。当后台监测到接口受到攻击,或其他异常情况时,将向指定的邮箱发送报警邮件,提示及时处理问题,开通数据报警功能进行可视化查看。

一、方案功能接口

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参数:

参数
access_token 通过API Key和Secret Key获取的access_token,参考“Access Token获取

Header:

参数
Content-Type application/json

Body中放置请求参数,参数详情如下:

请求参数

参数 必选 类型 说明
plan_id string 方案的id信息,请在人脸实名认证控制台查看创建的H5方案的方案ID信息

请求示例:

{
	"plan_id" : 1
}

返回参数

  • 返回结果
字段 必选 类型 说明
success boolean 返回请求是否成功信息。
若请求成功返回ture;
请求失败则返回false
result object 请求结果
+verify_token string 请求获取的verify_token
  • 返回示例

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

2.指定用户信息上报接口

本接口用于,前端在方案中选择身份信息录入-身份信息录入方式-指定用户身份核验时,需要先调用此接口输入指定用户的姓名+身份证号信息,再请求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://aip.baidubce.com/rpc/2.0/brain/solution/faceprint/idcard/submit

URL参数:

参数
access_token 通过API Key和Secret Key获取的access_token,参考“Access Token获取

Header:

参数
Content-Type application/json

Body中放置请求参数,参数详情如下:

参数 必选 类型
verify_token string 通过access_token获取的verify_token
id_name string 指定输入用户的姓名信息
id_no string 指定输入用户的身份证件号信息
certificate_type int 证件类型:
0 大陆居民二代身份证
4 港澳台居民居住证

请求示例:

{
    "verify_token": "2sF3nE5mXOHkx2aQwWG4n5WI",
    "id_name": "张三",
    "id_no": "500***********3390",
    "certificate_type": 0            // 证件类型:0:大陆居民二代身份证,4:港澳台居民居住证
}

返回参数

  • 返回结果
字段 必选 类型 说明
success boolean 返回请求是否成功信息。
若请求成功返回ture;
请求失败则返回false
result int 请求结果,返回固定结果1,可忽略
  • 返回示例

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

3.对比图片上传接口

本接口用于,前端在方案中选择比对源选择-自建人脸库比对时,需要先调用此接口上传待比对的自建人脸库中的指定人脸图片,再请求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://aip.baidubce.com/rpc/2.0/brain/solution/faceprint/uploadMatchImage

URL参数:

参数
access_token 通过API Key和Secret Key获取的access_token,参考“Access Token获取

Header:

参数
Content-Type application/json

Body中放置请求参数,参数详情如下:

参数 必选 类型
verify_token string 通过access_token获取的verify_token
image string 图片base64字符串,编码后的图片大小不超过10M,图片分辨率小于1920*1080
quality_control string NONE”、“LOW”、“NORMAL”、“HIGH”;
质量控制参数,未主动传入时默认为“NONE”
liveness_control string NONE”、“LOW”、“NORMAL”、“HIGH”;
活体控制参数,未主动传入时默认为“NONE”

请求示例:

{
    "verify_token": "2sF3nE5mXOHkx2aQwWG4n5WI",
    "image": "/9j/4AAQSkZJRgABAQAAAQABAAD/",
    "quality_control" : "LOW",
    "liveness_control" : "LOW",
}

返回参数

  • 返回结果
字段 必选 类型 说明
success boolean 返回请求是否成功信息。
若请求成功返回ture;
请求失败则返回false
log_id string logid
result object 返回结果
  • 返回示例

    {
      "success": true,
      "result": null,
      "log_id": "1329130892"
    }

二、验证后查询接口

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

1.获取认证人脸接口

本接口返回进行人脸实名认证过程中进行认证的最终采集的人脸信息。根据Verify_token返回的结果信息会在云端保留3天,您可根据需要在此期间进行调取查询。

在线调试

您可以在 示例代码中心 中调试该接口,可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。

调用方式

请求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参数:

参数
access_token 通过API Key和Secret Key获取的access_token,参考“Access Token获取

Header:

参数
Content-Type application/json

Body中放置请求参数,参数详情如下:

参数
verify_token 通过access_token获取的verify_token

请求示例:

{
	"verify_token" : "cIupeyP51sn28XzxGVTfYqoN"
}

返回参数

  • 返回结果
字段 必选 类型 说明
success boolean 返回请求是否成功信息。
若请求成功返回ture;
请求失败则返回false
result object 请求结果
+image string 返回采集的用户人脸信息
  • 返回示例

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

2.查询认证结果接口

本接口为请求返回的认证结果信息查询,包含身份证OCR识别信息、用户二次确认的身份证信息,活体检测信息、及用户对权威数据源图片进行比对的分数信息。(仅在认证成功时返回上述信息,认证失败返回错误码)根据Verify_token返回的结果信息会在云端保留3天,您可根据需要在此期间进行调取查询。

在线调试

您可以在 示例代码中心 中调试该接口,可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。

调用方式

请求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参数:

参数
access_token 通过API Key和Secret Key获取的access_token,参考“Access Token获取

Header:

参数
Content-Type application/json

Body中放置请求参数,参数详情如下:

参数
verify_token 通过access_token获取的verify_token

请求示例:

{
	"verify_token" : "cIupeyP51sn28XzxGVTfYqoN"
}

返回参数

  • 返回结果
字段 必选 类型 说明
success boolean 返回本次身份核验是否成功的结果。
成功返回ture;
失败则返回false
result object 请求结果
+idcard_ocr_result object 返回采集的身份证信息
当人脸实名认证控制台设置为使用OCR识别时返回此参数信息
++address string 地址
++birthday string 生日
++name string 姓名
++id_card_number string 身份证号
++gender string 性别
++nation string 民族
++expire_time string 身份证失效日期
++issue_authority string 身份证签发机关
++issue_time string 身份证生效日期
+idcard_images object 返回采集的身份证图片信息
当人脸实名认证控制台设置为使用OCR识别时返回此参数信息
++front_base64 string 身份证图片的正面信息
++back_base64 string 身份证图片的反面信息
当人脸实名认证控制台设置为使用OCR识别且为国徽面+人像面时返回此参数信息
+verify_result object 认证返还信息
++liveness_score float 活体检测分数:
活体验证通过时返回活体分数,不通过则返回0。
++score float 人脸实名认证
++spoofing float 合成图分数
若未进行合成图检测,则返回0
若进行活体检测,则返回合成图检测分值
is_demote bool 当配置为实时活体检测方案时是否降级,true为降级,false为不降级
+idcard_confirm object 用户二次确认的身份证信息
++name string 姓名
++idcard_number string 身份证号
  • 返回示例

    {
      "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返回的结果信息会在云端保留3天,您可根据需要在此期间进行调取查询。

在线调试

您可以在 示例代码中心 中调试该接口,可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。

调用方式

请求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参数:

参数
access_token 通过API Key和Secret Key获取的access_token,参考“Access Token获取

Header:

参数
Content-Type application/json

Body中放置请求参数,参数详情如下:

参数
verify_token 通过access_token获取的verify_token

请求示例:

{
	"verify_token" : "cIupeyP51sn28XzxGVTfYqoN"
}

返回参数

  • 返回结果
字段 必选 类型 说明
success boolean 返回请求是否成功信息。
若请求成功返回ture;
请求失败则返回false
result object 请求结果
+Verify_FIN array 人脸实名认证接口请求的统计信息
++error_code string 错误码编号
若为0则表示请求成功
++count int 当前错误码的请求数量
+Sessioncode array 随机校验码接口请求的统计信息
++error_code string 错误码编号
若为0则表示请求成功
++count int 当前错误码的请求数量
+OCR array OCR身份证识别接口请求的统计信息
++error_code string 错误码编号
若为0则表示请求成功
++count int 当前错误码的请求数量
+verify array 人脸实名认证接口请求的统计信息
++error_code string 错误码编号
若为0则表示请求成功
++count int 当前错误码的请求数量
+VideoLiveness array 视频活体检测接口请求的统计信息
++error_code string 错误码编号
若为0则表示请求成功
++count string 当前错误码的请求数量
+Livenesscolorful array 炫瞳活体检测接口请求的统计信息
++error_code string 错误码编号
若为0则表示请求成功
++count string 当前错误码的请求数量
+VerifySec array 人脸实名认证接口请求的统计信息
++error_code string 错误码编号
若为0则表示请求成功
++count string 当前错误码的请求数量
  • 返回示例

    {
        "success": true,
        "result": {
            "Verify_FIN": [
                {
                    "error_code": 0,
                    "count": 1
                }
            ],
             "Sessioncode": [
                {
                    "error_code": 0,
                    "count": 1
                }
            ],
            "OCR": [
                {
                    "error_code": 0,
                    "count": 2
                }
            ],
            "verify": [
                {
                    "error_code": 0,
                    "count": 1
                }
            ],
            "VideoLiveness": [
                {
                    "error_code": 0,
                    "count": 1
                }
            ]
            "Livenesscolorful": [
                {
                    "error_code": 0,
                    "count": 1
                }
            ]
            "VerifySec": [
                {
                    "error_code": 0,
                    "count": 1
                }
            ]
        },
        "log_id": "1405335905"
    }

4.实时方案视频获取

根据Verify_token返回的视频url会在云端保留1天,您可根据需要在此期间进行调取查询。

注意:H5方案中的视频录制功能默认不开启,调用本接口将无法获得视频数据,如您需要使用以上api,请联系商务经理或提交工单申请配置开通

调用方式

请求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/media/query

URL参数:

参数
access_token 通过API Key和Secret Key获取的access_token,参考“Access Token获取

Header:

参数
Content-Type application/json

Body中放置请求参数,参数详情如下:

参数
verify_token 通过access_token获取的verify_token

请求示例:

{
	"verify_token" : "cIupeyP51sn28XzxGVTfYqoN"
}

返回参数

  • 返回结果
字段 必选 类型 说明
success boolean 返回请求是否成功信息。
若请求成功返回ture;
请求失败则返回false
result object 视频url链接
+processVideo array H5实时炫瞳活体、H5实时动作活体、H5实时静默活体方案视频链接数组,一个verify_token仅对应一个视频
+video array H5数字活体、H5动作活体、H5视频活体、在线图片活体方案视频链接数组,一个verify_token仅对应一个视频,video和processVideo不会同时返回
+images array 图片链接数组,H5实时炫瞳活体、H5实时动作活体、H5实时静默活体方案所返回的4张人脸图片
+extInfo string 扩展信息,如有则代表处理视频中的错误信息
log_id string 日志ID
  • 返回示例
  {
    "success": true,
    "result": {
        "processVideo": [
            "http://bj.bcebos.com/v1/aa.mp4"
        ],
        "video": [
            "http://bj.bcebos.com/v1/aa.mp4"
        ],
        "images": [
            "http://bj.bcebos.com/v1/aa.jpg"
        ],
        "extInfo": null
    },
    "log_id": "1534116864874049322"
}

5.核验及计费信息获取

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

调用方式

请求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/getall

URL参数:

参数
access_token 通过API Key和Secret Key获取的access_token,参考“Access Token获取

Header:

参数
Content-Type application/json

Body中放置请求参数,参数详情如下:

参数
verify_token 通过access_token获取的verify_token

请求示例:

{
	"verify_token" : "cIupeyP51sn28XzxGVTfYqoN"
}

返回参数

  • 返回结果
字段 必选 类型 说明
success boolean 返回请求是否成功信息。
若请求成功返回ture;
请求失败则返回false
log_id string 本次查询接口请求的logid
result object 结果信息
+verify_count int 当前verify_token对应的核验次数,核验次数为几,后面就有几个对象数组
如方案配置为“认证未通过时URL失效”,则该verify_token核验次数为1;
如方案配置为“认证未通过时URL不失效”,则该verify_token对应的核验次数可能大于1(用户核验失败后多次重试)
+ocr_charge_count int 身份证识别OCR接口的计费次数
+match_charge_count int 人脸对比V4接口的计费次数
如方案配置为“认证未通过时URL失效”,计费次数最多为1;
如方案配置为“认证未通过时URL不失效”,则计费次数可能大于1(用户核验失败后多次重试);
+verify_charge_count int 人脸实名认证V4接口的计费次数
如方案配置为“认证未通过时URL失效”,计费次数最多为1;
如方案配置为“认证未通过时URL不失效”,则计费次数可能大于1(用户核验失败后多次重试);
+verify_result object[] 核验结果信息,verify_count的值为几,就返回几个该对象
++order int 代表本次核验结果在verify_token所有核验次数中的顺序,按时间先后排序,第一次核验返回值为 1,第二次核验返回值为 2,以此类推
++is_verify_passed boolean 本次核验是否通过
核验成功返回true
核验失败返回false
++code string 本次核验的错误码
核验成功时返回 0
核验失败返回非0错误码
++message string 本次核验的错误信息
核验成功时返回“核验成功”
核验失败时返回具体错误原因,如“身份证姓名不匹配”
++verify_time string 本次核验完成的时间点,包含年月日、时分秒,如“2023-6-20 18:00:00”
++is_charged boolean 本次核验是否计费
计费返回true
不计费返回false
++charge_type string 计费类型:verify(人脸实名认证V4)、match(人脸对比V4)
++charge_time string 本次计费的时间点,如不计费则该字段为空,包含年月日、时分秒,如“2023-6-20 18:00:00”
++is_ocr_charge boolean 身份证识别OCR是否计费
计费返回true
不计费返回false
++ocr_charge_time string ocr 收费时间点,如不收费则该字段为空,包含年月日、时分秒,如“2023-6-20 18:00:00”
++ocr_count int ocr次数
++verify_detail object 核验的详细信息
+++face_image string 本次核验流程中采集的人脸最佳质量图下载url
+++verify_log_id string 本次核验流程中请求的人脸实名认证V4(方案配置权威数据源比对)、人脸对比V4(方案配置自建人脸库比对)后端接口logid
可在记录查询平台中通过logid查询到3天内的记录。
少数核验失败情况下,实际并未发生上述俩接口的请求,则该字段为空,如:用户拒绝摄像头授权且不允许降级
+++score float 人脸相似度得分,大于等于方案设置阈值为同一人;当身份证姓名不匹配或活体不通过时,该项为空
+++threshold float 本次核验时,所使用的方案配置相似度阈值
+++liveness_score float 活体检测得分,注:预留功能字段,当前返回为0
+++spoofing_score float 方案配置使用合成图功能,将返回合成图得分,注:预留功能字段,当前返回为0
+++risk_level string 安全风控等级
方案配置启用安全风控,将返回该字段
值为1或2时表示触发了安全风险,值为3或4时无风险
+++risk_tag string 安全风控标签
方案配置启用安全风控,将返回该字段
当risk_level值为1或2时,返回具体风险类型,risk_level值为3或4时,为空
+++is_demote boolean 方案配置为实时检测时,将返回该字段,代表本次核验是否出现降级
降级返回true,未降级返回false
注:当环境不支持实时检测,且方案配置允许降级时,将降级为录制视频上传
++idcard_confirm object 用户手动输入或二次确认的身份证信息
+++name string 姓名
+++idcard_number string 证件号
+++idcard_type string 证件类型,大陆居民二代身份证返回0
++idcard_ocr_result object OCR采集的身份证信息,当方案配置使用OCR采集证件照时返回该参数
+++address string 地址
+++birthday string 生日
+++name string 姓名
+++idcard_number string 证件号
+++idcard_type string 证件类型,大陆居民二代身份证返回0
+++gender string 性别
+++nation string 民族
+++issue_time string 身份证生效日期
+++expire_time string 身份证失效日期
+++issue_authority string 身份证签发机关
++idcard_images object 返回采集的身份证图片信息
当人脸实名认证控制台设置为使用OCR识别时返回此参数信息
+++front_image string 身份证正面图片的下载url
+++back_image string 身份证背面图片的下载url
  • 返回示例
{
    "success":true,
    "log_id":"123456",
    "result":{
        "verify_count":1,
        "ocr_charge_count":1,
        "match_charge_count":1,
        "verify_charge_count":1,
        "verify_result":[
            {
                "order":1,
                "is_verify_passed":true,
                "code":"0",
                "message":"",
                "verify_time":"2023-10-10 10:10:10",
                "is_charged":true,
                "charge_type":"verify",
                "charge_time":"2023-10-10 10:10:10",
                "is_ocr_charge":true,
                "ocr_count":2,
                "ocr_charge_time":"2023-10-10 10:10:10",
                "verify_detail":{
                    "face_image":"xxx.jpg",
                    "verify_log_id":"xxx",
                    "score":89.9,
                    "threshold":80,
                    "liveness_score":80,
                    "spoofing_score":80,
                    "risk_level":"1",
                    "risk_tag":"xxx",
                    "is_demote":false
                },
                "idcard_confirm":{
                    "name":"张三",
                    "idcard_number":"36213219923232X",
                    "idcard_type":"0",
                    "idcard_ocr_result":{
                        "address":"江西省赣州市",
                        "birthday":"2020-10-10 10:10:10",
                        "name":"张三",
                        "idcard_number":"36213219923232X",
                        "idcard_type":"0",
                        "gender":"男",
                        "nation":"汉族",
                        "issue_time":"2020-10-10 10:10:10",
                        "expire_time":"2028-10-10 10:10:10",
                        "issue_authority":"江西省赣州市"
                    },
                    "idcard_images":{
                        "front_image":"xxx.jpg",
                        "back_image":"xxx.jpg"
                    }
                }
            }
        ]
    }
}

三、常见问题

1. verify_token的详细说明

(1)access_token 有效期为 30 天,重复生成 access_token 的话,对之前的不影响,依旧能使用;access_token 与verify_token 是包含关系,即 verify_token 是由 access_token生成的,如果一个 verify_token 是和一个不匹配的 access_token 使用,会提示“Token无效或者已过期”

(2)verify_token 的核验有效期为 2 小时,在有效期内可以进行了核验动作,如果超过了 2 小时没有使用该 token 进行核验的话会提示“Token无效或者已过期”

(3) verify_token 核验完毕后(核验成功,或设置了认证未通过时URL失效),无法再进行核验,如果再次进行核验,会提示“Token无效或者已过期”

(4) verify_token 核验完毕后(核验成功,或设置了认证未通过时URL失效),支持对后验接口的查询,有效期均为 3 天,3 天后再次查询后验接口,会提示“Token无效或者已过期”

2. 获取认证人脸、查询认证结果、核验及计费信息获取接口持续返回错误码18,提示openapi限制,且有返回logid

答:检查H5方案依赖的“人脸实名认证V4”、“人脸对比V4”两项付费接口,是否有免费额度,或者直接开通后付费,以消除该报错提示。开通后,再进行重试。

上一篇
APP内嵌H5兼容性配置
下一篇
纯服务端接入