H5接入意愿核身

更新时间：2024-10-15

意愿核身（权威库）

获取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

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

接入指南

纯服务端接入

人脸识别

H5接入意愿核身

一、方案功能接口

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

在线调试

调用方式

请求说明

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

在线调试

调用方式

请求说明

3.对比图片上传接口

在线调试

调用方式

请求说明

二、验证后查询接口

1.获取认证人脸接口

在线调试

调用方式

请求说明

2.查询认证结果接口（包含意愿核验结果）

在线调试

调用方式

请求说明

3.查询统计结果

在线调试

调用方式

请求说明

4.实时方案视频获取

调用方式

在线调试

请求说明

5.核验及计费信息获取（包含意愿核验结果）

调用方式

在线调试

请求说明

三、常见问题

1. verify_token的详细说明

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