人证核身服务 IVS-使用身份证图片、人脸视频验证:响应参数

时间:2024-04-29 09:56:07

响应参数

状态码: 200

表6 响应Body参数

参数

参数类型

描述

meta

Meta object

请求元数据,例如表征本次请求的唯一标注uuid。

result

result object

调用返回结果。

表7 Meta

参数

参数类型

描述

uuid

String

唯一标识此次请求的ID,用户自定义,不超过64位。

表8 result

参数

参数类型

描述

service_name

String

子服务名称。

count

Integer

执行检测的数量,与resp_data字段对应。

resp_data

Array of RespDataByVideoAndIdCardImage objects

请求列表,用于支持批量调用。目前暂时只支持单个数据查询。

表9 RespDataByVideoAndIdCardImage

参数

参数类型

描述

verification_result

String

审核校验结果: "valid"表示身份审核通过; "invalid"表示身份审核不通过; "nonexistent"表示数据源没有该身份证号码,这种情况一般是被验证人正在办理户籍迁移,或者被验证人是军人或政要。

verification_message

String

审核校验信息,具体参考校验信息说明

verification_code

Integer

审核校验代码,具体参考校验信息说明

similarity

String

人像相识度。取值范围[0,100],当入参detail为true时,取值范围为[0,1000]。

idcard_result

IdcardResult object

身份证图像的文字识别结果,具体参见IdcardResult

video_result

VideoResult object

动作活体检测的检测结果。

表10 IdcardResult

参数

参数类型

描述

name

String

身份证上识别的名称。

number

String

身份证号。

sex

String

性别。

birth

String

出生日期。

ethnicity

String

民族。

address

String

地址。

issue

String

发证机关。

valid_from

String

有效起始日期。

valid_to

String

有效结束日期。

表11 VideoResult

参数

参数类型

描述

alive

Boolean

是否是活体。

actions

Array of ActionsList objects

动作列表。

picture

String

检测出最大人脸的图片base64。

表12 ActionsList

参数

参数类型

描述

confidence

Double

置信度,取值范围0~1。

action

Integer

动作编号,取值范围:[1,2,3,4],其中: 1:左摇头 2:右摇头 3:点头 4:嘴部动作

状态码: 400

表13 响应Body参数

参数

参数类型

描述

error_code

String

调用失败时的错误码,具体请参考错误码。 调用成功时无此字段。

error_msg

String

调用失败时的错误信息。 调用成功时无此字段。

support.huaweicloud.com/api-ivs/ivs_02_0027.html