检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
区域与可用区 什么是区域与可用区
活体人证核验解决方案 方案概述 资源与成本规划 实施步骤 附录
调用API或SDK 在线调试 本地调用
CallTimeoutException 单次请求，服务器处理超时未返回。 RetryOutageException 在重试策略消耗完成后，仍无有效的响应。 ServiceResponseException 服务器响应异常 ServerResponseException 服务端内部错误，Http响应码：[500
企业项目管理 应用场景简介 创建企业项目 企业项目财务管理
实施步骤 准备工作 自动化部署步骤 开始使用 快速卸载 父主题： 活体人证核验解决方案
终端节点即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 人证核身的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。 表1 人证核身的终端节点 区域名称 区域 终端节点（Endpoint） 部署服务 华北-北京四 cn-north-4
标准版（三要素） 使用身份证图片、人脸图片验证 使用身份证文本、人脸图片验证 使用身份证图片、人脸视频验证 使用身份证文本、人脸视频验证 父主题： API
校验信息说明 表1 验证信息 检验代码 检验结果 检验信息 说明 1000 valid Successful certification 认证成功。 2001 invalid Inconsistent identity information 认证信息不一致，即姓名与身份证号码不一致。
准备工作 开通人证核身服务 登录人证核身控制台。 在控制台左上角选择区域为“北京四”，并开通“人证核身标准版（三要素）”。 开通后，默认为按需计费。 图1 开通“人证核身标准版（三要素）” 开通人脸识别服务 登录人脸识别控制台。 在控制台左上角选择区域为“北京四”，并开通“动作活体检测”。
查看API使用次数 登录人证核身服务控制台。 在“云上服务管理”页面，查看API的使用量和套餐包的使用量。 图1 API使用量统计 父主题： API使用类
IdcardResult 身份证图像文字识别结果结构体。 表1 结构体说明 参数 类型 描述 name String 身份证上识别的名称。 number String 身份证号。 sex String 性别。 birth String 出生日期。 ethnicity String
选择需要使用的服务，在操作列单击“开通服务”。本示例中开通人证核身证件版（二要素）API。 图1 开通服务 服务开通成功后，开通状态显示“已开通”。 首次使用服务时，需要先申请开通该服务。服务只需要开通一次即可，后面使用时无需再次申请。如未开通服务，调用服务时会提示IVS.0015报错。
快速卸载 在进行一键卸载之前，需要先删除该方案创建的委托。 删除委托 登录统一身份认证服务（IAM）控制台。 进入“委托”页面，删除委托。 图1 删除委托 一键卸载 登录人证核身解决方案部署页面。 单击方案堆栈后的“删除”。 图2 一键卸载 在弹出的删除堆栈确认框中，输入方案的堆
接口的并发是多少 人证核身标准版（三要素）、人证核身证件版（二要素）默认并发为10qps。 父主题： API使用类
您可以尝试以下方案进行解决。 Token有效期为24小时，请使用重新获取Token调用API。 检查接口URL中的终端节点是否填写正确。部署在不同区域间的服务，不可以跨区域调用。如果调用了不同区域的接口，导致判断为Token失效，显示APIG.0307错误码。 父主题： 错误码类
问题现象 调用人证核身接口时，报错“IVS.0015”。 该报错表示调用的API没有开通。 解决方法 请先登录控制台开通所需的服务。 如已开通，检查开通服务区域和实际调用的API的区域是否一致。 图1 检查区域信息 父主题： 错误码类
您可以跳过本章节，不影响您使用IVS服务的其它功能。 前提条件 给用户组授权之前，请您了解用户组可以添加的IVS系统权限，并结合实际需求进行选择，IVS支持的系统权限，请参见权限管理。 操作步骤 创建用户组并授权 使用主账号登录IAM服务控制台。 左侧导航窗格中，选择“用户组”页签，单击右上方的“+创建用户组”。
创建企业项目 创建企业项目的用户必须是管理员，或在IAM侧已被授予EPS FullAccess权限的用户。 企业账号可申请开通企业项目。账号需要进行企业实名认证。如果企业账号注册成为华为云合作伙伴，将无法进入企业项目管理页面。 图1 操作流程 创建IAM用户并授权使用IVS 创建
自动化部署步骤 登录华为云解决方案实施库，选择“一键部署”。 图1 一键部署人证核身解决方案 在选择模板界面中，直接单击“下一步：配置参数”。 图2 选择模板 在配置参数界面中，自定义填写堆栈名称。根据表完成参数配置后，单击“下一步：高级配置”。 图3 配置参数 表1 参数说明 参数名称
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
