检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
返回结果 状态码 请求发送以后,您会收到响应,包含状态码、响应消息头和消息体。 状态码是一组数字代码,状态码表示了请求响应的状态,如果调用后返回状态码为2xx,则表示调用成功。完整的状态码列表请参见状态码。
单击“调试”按钮,获取识别结果。 父主题: 调用API或SDK
单击“发起请求”,即可获取调试结果。
如何调用API 申请服务 构造请求 认证鉴权 返回结果
API会返回JSON格式的识别结果,用户需要通过编码将识别结果对接到业务系统中。 关于人证核身服务的相关声明请参见人证核身服务免责声明。 人证核身服务等级协议请参见华为云服务等级协议。
result result object 调用返回结果。 表7 Meta 参数 参数类型 描述 uuid String 唯一标识此次请求的ID,用户自定义,不超过64位。 表8 result 参数 参数类型 描述 service_name String 子服务名称。
运行代码示例,获取识别结果。 识别结果返回“valid”,表示认证成功。 父主题: 调用API或SDK
idcard_result IdcardResult object 身份证图像的文字识别结果,具体参见IdcardResult。 video_result VideoResult object 动作活体检测的检测结果。
用户调用API接口需要具备一定的编程开发基础,识别后返回的结果为JSON格式,用户需要通过编程来处理识别结果。 您可以选择合适的方式进行使用,使用前请参考申请服务开通所需要的API。 通过华为云API Explorer在线调用IVS服务API。
result result object 调用返回结果。 表7 Meta 参数 参数类型 描述 uuid String 唯一标识此次请求的ID,用户自定义,不超过64位。 表8 result 参数 参数类型 描述 service_name String 子服务名称。
表1 常用最佳实践 实践 描述 活体人证核身 该实践基于于华为云人证核身服务IVS和人脸识别服务FRS构建,通过动作活体检测判断操作用户是否为真人,并将检测结果与用户身份证信息关联起来,使用人证核身技术,实现对用户身份真实性的核验。
result result object 调用返回结果。 表7 Meta 参数 参数类型 描述 uuid String 唯一标识此次请求的ID,用户自定义,不超过64位。 表8 result 参数 参数类型 描述 service_name String 子服务名称。
IdcardResult 身份证图像文字识别结果结构体。 表1 结构体说明 参数 类型 描述 name String 身份证上识别的名称。 number String 身份证号。 sex String 性别。 birth String 出生日期。
区域(Region):从地理位置和网络时延维度划分,同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。
错误码 调用接口出错后,将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。当调用出错时,HTTPS请求返回一个 4xx 或 5xx 的 HTTPS状态码。返回的消息体中是具体的错误代码及错误信息。
Postman等工具直接调用服务,查看是否成功,如果调用成功表示服务接口没有问题,请执行如下步骤1和步骤2进行检查: 请检查原调用请求是否过于频繁,如果是并发过大,可以通过重试机制解决,在代码里检查返回值,碰到这个并发错误可以延时一小段时间(如2-5s)重试请求;也可以后端检查上一个请求结果
方案概述 应用场景 该解决方案基于华为云人证核身服务IVS和人脸识别服务FRS构建,通过动作活体检测判断操作用户是否为真人,并将检测结果与用户身份证信息关联起来,使用人证核身技术,实现对用户身份真实性的核验。
区域(Region) 从地理位置和网络时延维度划分,同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。
图10 查看识别结果
运行代码示例,获取识别结果。 识别结果返回“valid”,表示认证成功。