检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
如何调用API 申请服务 构造请求 认证鉴权 返回结果
公共数据结构 校验信息说明 IdcardResult
概述 人证核身服务（Identity Verification Solution，简称IVS）是结合人脸识别、文字识别等技术，对用户身份进行真实性核验。 人证核身服务以开放API的方式提供给用户，您可以根据本文档提供的API来使用服务。 在调用人证核身服务API之前，请确保已经充
调用说明 人证核身提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 父主题： 使用前必读
参数 是否必选 参数类型 描述 req_data 否 Array of ReqDataByIdCardImage objects 请求列表，用于支持批量调用。目前暂时只支持单个数据查询。 表5 ReqDataByIdCardImage 参数 是否必选 参数类型 描述 idcard_image1
返回结果 状态码 请求发送以后，您会收到响应，包含状态码、响应消息头和消息体。 状态码是一组数字代码，状态码表示了请求响应的状态，如果调用后返回状态码为2xx，则表示调用成功。完整的状态码列表请参见状态码。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。例如表1所示。
https://{endpoint}/v3/projects”，其中“{endpoint}”为IAM的终端节点。接口的认证鉴权请参见认证鉴权。 响应示例如下，例如，人证核身服务部署的区域为“cn-north-4”，响应消息体中查找“name”为“cn-north-4”，其中“projects”下的“id”即为项目ID。
区域与可用区 什么是区域与可用区
活体人证核验解决方案 方案概述 资源与成本规划 实施步骤 附录
调用API或SDK 在线调试 本地调用
oject name的获取方法参见获取用户名、用户ID、项目名称、项目ID。 获取Token的终端节点和project name需与IVS服务终端节点保持一致。当访问华北-北京四的终端节点（即访问https://ivs.cn-north-4.myhuaweicloud.com时）
约束与限制 只支持“华北-北京四”区域。 只支持中国大陆身份证的识别。 只支持JPG格式，图片中人像需无遮挡。 图像数据，base64编码，要求base64编码后大小不超过4MB。 图像各边的像素大小在300到8000px之间。 图像中身份证区域有效占比超过15%，保证整张身份证内容及其边缘包含在图像内。
Explorer调试API。 前提条件 注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费、冻结、被注销等异常状态。 已开通人证核身服务。 操作步骤 登录API Explorer。 登录后，“X-Auth-Token”和“project_id”参数会自动填充，无需填写。 填写待验证的身份证信息。
ion）请参见权限管理。 目前华为云支持以下两种方式创建自定义策略： 可视化视图创建自定义策略：无需了解策略语法，按可视化视图导航栏选择云服务、操作、资源、条件等策略内容，可自动生成策略。 JSON视图创建自定义策略：可以在选择策略模板后，根据具体需求编辑策略内容；也可以直接在编辑框内编写JSON格式的策略内容。
实施步骤 准备工作 自动化部署步骤 开始使用 快速卸载 父主题： 活体人证核验解决方案
终端节点即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 人证核身的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。 表1 人证核身的终端节点 区域名称 区域 终端节点（Endpoint） 部署服务 华北-北京四 cn-north-4
参数类型 描述 req_data 否 Array of ReqDataByVideoAndIdCardImage objects 请求列表，用于支持批量调用。目前暂时只支持单个数据查询。 表5 ReqDataByVideoAndIdCardImage 参数 是否必选 参数类型 描述
快速卸载 在进行一键卸载之前，需要先删除该方案创建的委托。 删除委托 登录统一身份认证服务（IAM）控制台。 进入“委托”页面，删除委托。 图1 删除委托 一键卸载 登录人证核身解决方案部署页面。 单击方案堆栈后的“删除”。 图2 一键卸载 在弹出的删除堆栈确认框中，输入方案的堆
您可以跳过本章节，不影响您使用IVS服务的其它功能。 前提条件 给用户组授权之前，请您了解用户组可以添加的IVS系统权限，并结合实际需求进行选择，IVS支持的系统权限，请参见权限管理。 操作步骤 创建用户组并授权 使用主账号登录IAM服务控制台。 左侧导航窗格中，选择“用户组”页签，单击右上方的“+创建用户组”。
准备工作 开通人证核身服务 登录人证核身控制台。 在控制台左上角选择区域为“北京四”，并开通“人证核身标准版（三要素）”。 开通后，默认为按需计费。 图1 开通“人证核身标准版（三要素）” 开通人脸识别服务 登录人脸识别控制台。 在控制台左上角选择区域为“北京四”，并开通“动作活体检测”。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
