如需了解国际站更多云产品，请访问国际站。https://www.huaweicloud.com/intl/
不再显示此消息
如需了解国际站更多云产品，请访问国际站。https://www.huaweicloud.com/intl/
不再显示此消息
调用API或SDK 在线调试 本地调用
活体人证核验解决方案 方案概述 资源与成本规划 实施步骤 附录
附录 获取OBS中对象URL 父主题： 活体人证核验解决方案
newBuilder() 网络代理（可选） // 使用代理服务器（可选） client.withProxyAgent("http://username:password@proxy.huaweicloud.com:8080") SSL配置（可选） // 配置跳过服务端证书验证（可选） process.env
调用说明 人证核身提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 父主题： 使用前必读
https://{endpoint}/v3/projects”，其中“{endpoint}”为IAM的终端节点。接口的认证鉴权请参见认证鉴权。 响应示例如下，例如，人证核身服务部署的区域为“cn-north-4”，响应消息体中查找“name”为“cn-north-4”，其中“projects”下的“id”即为项目ID。
Explorer调试API。 前提条件 注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费、冻结、被注销等异常状态。 已开通人证核身服务。 操作步骤 登录API Explorer。 登录后，“X-Auth-Token”和“project_id”参数会自动填充，无需填写。 填写待验证的身份证信息。
终端节点即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 人证核身的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。 表1 人证核身的终端节点 区域名称 区域 终端节点（Endpoint） 部署服务 华北-北京四 cn-north-4
会返回校验失败的具体原因。 前提条件 注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费、冻结、被注销等异常状态。 已开通人证核身服务。 操作步骤 获取并安装IVS Python SDK。 以PyCharm为例，介绍如何安装SDK。 在PyCharm中新建一个项目，并单击
获取账号ID 在调用接口的时候，部分URL中需要填入账号ID（domain-id），所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下： 登录管理控制台。 单击用户名，在下拉列表中单击“我的凭证”。 在“我的凭证”页面的项目列表中查看账号ID。 图1 查看账号ID 父主题：
部署该解决方案会使用到如下资源： API网关：API托管服务， 通过APIG，对外提供人证核身和人脸识别的组合API能力。 函数工作流：用于实现人证核身和人脸识别的组合业务逻辑，并通过APIG对外提供服务。 人脸识别服务：提供动作活体检测功能，判断当前用户是否为真人。 人证核身服务：将活体检测截取的人脸照片与
选择需要使用的服务，在操作列单击“开通服务”。本示例中开通人证核身证件版（二要素）API。 图1 开通服务 服务开通成功后，开通状态显示“已开通”。 首次使用服务时，需要先申请开通该服务。服务只需要开通一次即可，后面使用时无需再次申请。如未开通服务，调用服务时会提示IVS.0015报错。
实施步骤 准备工作 自动化部署步骤 开始使用 快速卸载 父主题： 活体人证核验解决方案
约束与限制 只支持“华北-北京四”区域。 只支持中国大陆身份证的识别。 只支持JPG格式，图片中人像需无遮挡。 图像数据，base64编码，要求base64编码后大小不超过4MB。 图像各边的像素大小在300到8000px之间。 图像中身份证区域有效占比超过15%，保证整张身份证内容及其边缘包含在图像内。
步骤3：获取示例代码 步骤4：调用服务 准备工作前提条件 账号完成实名认证，且不能处于欠费或冻结状态。 步骤1：开通服务 登录人证核身服务控制台。 选择需要使用的服务，在操作列单击“开通服务”。本示例中开通人证核身证件版（二要素）API。 图1 开通服务 服务开通成功后，开通状态显示“已开通”。
接口的并发是多少 人证核身标准版（三要素）、人证核身证件版（二要素）默认并发为10qps。 父主题： API使用类
参考。 表1 产品配置说明 产品 配置示例 人脸识别服务 区域：华北-北京四 计费模式：按需计费 涉及服务：动作活体检测 人证核身服务 区域：华北-北京四 计费模式：按需计费 涉及服务：人证核身标准版（三要素） 函数工作流服务 区域：华北-北京四 计费模式：按需计费 函数内存：128MB
问题现象 调用人证核身接口时，报错“IVS.0015”。 该报错表示调用的API没有开通。 解决方法 请先登录控制台开通所需的服务。 如已开通，检查开通服务区域和实际调用的API的区域是否一致。 图1 检查区域信息 父主题： 错误码类
快速卸载 在进行一键卸载之前，需要先删除该方案创建的委托。 删除委托 登录统一身份认证服务（IAM）控制台。 进入“委托”页面，删除委托。 图1 删除委托 一键卸载 登录人证核身解决方案部署页面。 单击方案堆栈后的“删除”。 图2 一键卸载 在弹出的删除堆栈确认框中，输入方案的堆
"error_code":"APIG.0201"，表示请求超时。 您可以尝试以下方案进行解决。 使用Postman等工具直接调用服务，查看是否成功，如果调用成功表示服务接口没有问题，请执行如下步骤1和步骤2进行检查： 请检查原调用请求是否过于频繁，如果是并发过大，可以通过重试机制解决，在
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
您即将访问非华为云网站，请注意账号财产安全
