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

H5接入意愿核身

意愿核身(权威库)

  • 获取verify_token+上传意愿核验文本信息:意愿核身流程开始,初始化获取唯一的流程token,同时上传意愿核验需要的朗读问题/答案列表文本
  • 对比图片上传:意愿核身流程中,提前上传用于1:1人脸比对的人脸底图

意愿核身(自传图片)

  • 获取verify_token+上传意愿核验文本信息:意愿核身流程开始,初始化获取唯一的流程token,同时上传意愿核验需要的朗读问题/答案列表文本
  • 指定用户信息上报:意愿核身流程中,提前上传用于权威库验证时的用户身份证号码、姓名,实现无需用户拍照或手动输入,直接进行活体及识别

意愿核身结果查询

  • 获取认证人脸:获取认证成功最终采集的人脸信息
  • 查询认证结果:获取身份证信息(仅在使用OCR的情况下返回)、活体检测分数、人脸相似度得分、意愿核验结果
  • 实时方案视频获取:获取实时活体检测过程的视频/图片
  • 核验及计费信息获取:获取对应verify_token下的所有核验信息(人脸、身份信息、认证结果、意愿核验结果),以及后端接口「意愿核身(权威库)」、「意愿核身(自传图片)」的计费与否及计费时间

一、方案功能接口

1.获取verify_token+上传意愿核验文本信息接口

本接口为意愿核身方案的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信息
will_verify object 意愿核验相关参数
+ verify_text string 意愿核验系统播报问题文本内容,建议控制文本长度在50字以内。如「请问您本次业务是本人自愿办理吗?」
+ verify_answer array 意愿核验回答问题答案,支持传入多个,文本之前请用,分割。如「是的,我确认」、「是的,是我本人」
+ spd string 语速,取值0-15,默认为5中语速,数值越高语速越快
+ pit string 音调,取值0-15,默认为5中语调,数值越高语调越高
+ vol string 音量,基础音库取值0-9,默认为5中音量(取值为0时为音量最小值,并非为无声)

请求示例:

{
   "plan_id": 21012,
   "will_verify": {
       "verify_text": "请问您本次业务是本人自愿办理吗",
       "verify_answer": [
           "是的,我确认",
           "是的,是我本人"
       ],
       "spd": "7", //通过传参适当调快语速
       "pit": "6", //通过传参适当调整音调
       "vol": "8" //通过传参适当调高音量
   }
}

返回参数

  • 返回结果
字段 必选 类型 说明
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 意愿核身(权威库)、意愿核身(自传图片)的比对得分(仅活体检测时返回为0)
++spoofing float 合成图分数
若未进行合成图检测,则返回0
若进行活体检测,则返回合成图检测分值
++will_verify object 意愿核身方案的核验结果
+++asr_result string 意愿核身方案的音频实时识别结果
+++verify_status string 意愿核身方案的核验结果状态
+++audio string 意愿核身方案的音频下载链接
+++screenshot_url string 意愿核身方案中的屏幕截图地址
+++video string 意愿核身方案的视频下载链接
is_demote bool 当配置为实时活体检测方案时是否降级,true为降级,false为不降级
+idcard_confirm object 用户二次确认的身份证信息
++name string 姓名
++idcard_number string 身份证号
  • 返回示例

    {
      "success": true,
      "result": {
          "verify_result": {
              "will_verify": {
                  "asr_result": "是的我确认",
                  "verify_status": "0",
                  "audio": "https://bj.bcebos.com",
                  "screenshot_url": "https://bj.bcebos.com",
                  "video": "https://bj.bcebos.com"
              },
              "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 意愿核身2个接口请求的统计信息
++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 意愿核身2个接口请求的统计信息
++error_code string 错误码编号
若为0则表示请求成功
++count int 当前错误码的请求数量
+VideoLiveness array 视频活体检测接口请求的统计信息
++error_code string 错误码编号
若为0则表示请求成功
++count string 当前错误码的请求数量
+Livenesscolorful array 炫瞳活体检测接口请求的统计信息
++error_code string 错误码编号
若为0则表示请求成功
++count string 当前错误码的请求数量
+VerifySec array 意愿核身2个接口请求的统计信息
++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 意愿核身(自传图片)人的计费次数
如方案配置为“认证未通过时URL失效”,计费次数最多为1;
如方案配置为“认证未通过时URL不失效”,则计费次数可能大于1(用户核验失败后多次重试);
+verify_charge_count int 意愿核身(权威库)的计费次数
如方案配置为“认证未通过时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(意愿核身(权威库))、match(意愿核身(自传图片))
++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 核验的详细信息
+++will_verify_result object 意愿核身结果
++++audio object 音频下载链接
++++screenshot_url object 屏幕截图地址
++++asr_result object 音频实时识别结果
++++verify_status object 意愿核验结果状态
+++face_image string 本次核验流程中采集的人脸最佳质量图下载url
+++verify_log_id string 本次核验流程中请求的意愿核身(权威库)、意愿核身(自传图片)2个后端接口的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,
                    "will_verify_result": {
                        "audio": "https://bj.bcebos.com",
                        "screenshot_url": "https://bj.bcebos.com",
                        "asr_result": "是的我确认",
                        "verify_status": "0"
                    }
                },
                "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

答:检查意愿核身方案依赖的“意愿核身(权威库)”、“意愿核身(自传图片)”两项付费接口,是否有免费额度,或者直接开通后付费,以消除该报错提示。开通后,再进行重试。

上一篇
接入指南
下一篇
纯服务端接入