检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
“verification_name ”被验证人的姓名,或者“verification_id ”被验证人的身份证号码,未传参。 通过API使用 用户可以通过API网关服务提供的发布API功能,将调试成功的解决方案,发布为API,基于该API进行二次开发,并对接到业务系统中。 父主题:
显示这些生僻字,但由于实名认证时公安系统是根据汉字编码进行比较,而这些生僻字PUA编码和GB18030编码并不一致,所以核验不会通过。 解决方案: 通过第三方网站提供的生僻字查询功能,传入生僻字以其他方式编码的姓名进行核验(https://name.vurls.cn/ui/index/uigen/)。
验服务应用效果。 通过可视化工具(如curl、Postman)发送请求调用IVS服务API。 如果您是开发工程师,熟悉代码编写,熟悉HTTP请求与API调用,您可以通过postman调用、调试API。使用方法请参见调用API实现人证核身证件版(二要素)。 通过软件开发工具包(SDK)调用IVS服务API。
终端节点 终端节点即调用API的请求地址,不同服务不同区域的终端节点不同,您可以从地区和终端节点中查询所有服务的终端节点。 人证核身的终端节点如表1所示,请您根据业务需要选择对应区域的终端节点。 表1 人证核身的终端节点 区域名称 区域 终端节点(Endpoint) 部署服务 华北-北京四
service has been frozen. 服务已冻结。 请检查是否有欠费。 400 IVS.0015 The subservice has not been subscribed. 服务未开通。 请登录控制台开通人证核身服务。 已开通情况下,检查服务的开通区域和调用API时,url中填写的区域是否一致。
份证内容及其边缘包含在图像内。 支持图像中身份证要求水平放置。 目前支持检测视频文件,或视频的Base64编码,不支持直接检测视频流,需要用户客户端自己获取视频流并保存成文件,然后调用活体检测接口。 视频文件大小不超过8MB,建议客户端压缩到200KB~2MB。 限制视频时长1~15秒。
什么是人证核身 人证核身服务(Identity Verification Solution,简称IVS),是指通过用户的身份证信息、人脸图片,与权威数据库进行比对,进而实现身份验证。 当前,人证核身提供以下子功能: 标准版(三要素) 使用姓名、身份证号码、人脸图像三要素进行匹配核验。
约束与限制 只支持“华北-北京四”区域。 只支持中国大陆身份证的识别。 支持港澳台居住证核验,证件信息需文本输入 只支持JPG格式,图片中人像需无遮挡。 图像数据,base64编码,要求base64编码后大小不超过4MB。 图像各边的像素大小在300到8000px之间。 图像中身
SDK简介 人证核身服务端SDK是对人证核身提供的REST API进行的封装,您可以直接继承服务端从而实现对人证核身服务的快速操作。 接口与API对应关系 表1 接口与API对应关系 接口 API 人证核身标准版(三要素) POST https://{endpoint}/v2.0/ivs-standard
返回结果 状态码 请求发送以后,您会收到响应,包含状态码、响应消息头和消息体。 状态码是一组数字代码,状态码表示了请求响应的状态,如果调用后返回状态码为2xx,则表示调用成功。完整的状态码列表请参见状态码。 响应消息头 对应请求消息头,响应同样也有消息头,如“Content-type”。例如表1所示。
接口的并发是多少 人证核身标准版(三要素)、人证核身证件版(二要素)默认并发为10qps。 父主题: API使用类
IdcardResult 身份证图像文字识别结果结构体。 表1 结构体说明 参数 类型 描述 name String 身份证上识别的名称。 number String 身份证号。 sex String 性别。 birth String 出生日期。 ethnicity String
您可以尝试以下方案进行解决。 Token有效期为24小时,请使用重新获取Token调用API。 检查接口URL中的终端节点是否填写正确。部署在不同区域间的服务,不可以跨区域调用。如果调用了不同区域的接口,导致判断为Token失效,显示APIG.0307错误码。 父主题: 错误码类
是否支持生僻字识别,少数民族字体识别 支持部分生僻字识别。 不支持少数民族语言文字识别。 父主题: API使用类
新特性将在各个区域(Region)陆续发布,欢迎体验。 2021年08月 序号 功能名称 功能描述 阶段 相关文档 1 上线人证核身服务 通过用户的身份证信息、人脸图片,与权威数据库进行比对,进而实现身份验证。 商用 产品介绍
求使用IVS提供的入门实践。 表1 常用最佳实践 实践 描述 活体人证核身 该实践基于于华为云人证核身服务IVS和人脸识别服务FRS构建,通过动作活体检测判断操作用户是否为真人,并将检测结果与用户身份证信息关联起来,使用人证核身技术,实现对用户身份真实性的核验。 同时,IVS三要
参数 参数类型 描述 verification_result String 审核校验结果: "valid"表示身份审核通过; "invalid"表示身份审核不通过; "nonexistent"表示数据源没有该身份证号码,这种情况一般是被验证人正在办理户籍迁移,或者被验证人是军人或政要。
调用说明 人证核身提供了REST(Representational State Transfer)风格API,支持您通过HTTPS请求调用,调用方法请参见如何调用API。 父主题: 使用前必读
参数 参数类型 描述 verification_result String 审核校验结果: "valid"表示身份审核通过; "invalid"表示身份审核不通过; "nonexistent"表示数据源没有该身份证号码,这种情况一般是被验证人正在办理户籍迁移,或者被验证人是军人或政要。
参数 参数类型 描述 verification_result String 审核校验结果: "valid"表示身份审核通过; "invalid"表示身份审核不通过; "nonexistent"表示数据源没有该身份证号码,这种情况一般是被验证人正在办理户籍迁移,或者被验证人是军人或政要。