检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 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。 父主题： 使用前必读
返回结果 状态码 请求发送以后，您会收到响应，包含状态码、响应消息头和消息体。 状态码是一组数字代码，状态码表示了请求响应的状态，如果调用后返回状态码为2xx，则表示调用成功。完整的状态码列表请参见状态码。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。例如表1所示。
区域与可用区 什么是区域与可用区
活体人证核验解决方案 方案概述 资源与成本规划 实施步骤 附录
调用API或SDK 在线调试 本地调用
约束与限制 只支持“华北-北京四”区域。 只支持中国大陆身份证的识别。 只支持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
部署该解决方案会使用到如下资源： API网关：API托管服务， 通过APIG，对外提供人证核身和人脸识别的组合API能力。 函数工作流：用于实现人证核身和人脸识别的组合业务逻辑，并通过APIG对外提供服务。 人脸识别服务：提供动作活体检测功能，判断当前用户是否为真人。 人证核身服务：将活体检测截取的人脸照片与
参考。 表1 产品配置说明 产品 配置示例 人脸识别服务 区域：华北-北京四 计费模式：按需计费 涉及服务：动作活体检测 人证核身服务 区域：华北-北京四 计费模式：按需计费 涉及服务：人证核身标准版（三要素） 函数工作流服务 区域：华北-北京四 计费模式：按需计费 函数内存：128MB
您可以跳过本章节，不影响您使用IVS服务的其它功能。 前提条件 给用户组授权之前，请您了解用户组可以添加的IVS系统权限，并结合实际需求进行选择，IVS支持的系统权限，请参见权限管理。 操作步骤 创建用户组并授权 使用主账号登录IAM服务控制台。 左侧导航窗格中，选择“用户组”页签，单击右上方的“+创建用户组”。
企业项目财务管理 开通了企业项目的客户，可以按企业项目查看各个企业项目的月度消费汇总、消费明细、产品费用走势和费用分布。 进入项目管理的“企业项目管理”页面，单击企业项目操作列的“查看消费 ”，查看各企业项目的费用信息。 图1 查看费用信息 父主题： 企业项目管理
APIG.0301报错处理方法 如果在调用API时返回错误信息与错误码： "error_msg":"Incorrect IAM authentication information: decrypt token fail","error_code":"APIG.0301"，是因为token解密失败。
您可以尝试以下方案进行解决。 Token有效期为24小时，请使用重新获取Token调用API。 检查接口URL中的终端节点是否填写正确。部署在不同区域间的服务，不可以跨区域调用。如果调用了不同区域的接口，导致判断为Token失效，显示APIG.0307错误码。 父主题： 错误码类
问题现象 调用人证核身接口时，报错“IVS.0015”。 该报错表示调用的API没有开通。 解决方法 请先登录控制台开通所需的服务。 如已开通，检查开通服务区域和实际调用的API的区域是否一致。 图1 检查区域信息 父主题： 错误码类
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
