检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
返回结果 状态码 请求发送以后，您会收到响应，包含状态码、响应消息头和消息体。 状态码是一组数字代码，状态码表示了请求响应的状态，如果调用后返回状态码为2xx，则表示调用成功。完整的状态码列表请参见状态码。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type
APIG.0201报错处理方法 如果调用API时返回错误信息与错误码："error_msg":"Backend timeout.","error_code":"APIG.0201"，表示请求超时。 您可以尝试以下方案进行解决。 使用Postman等工具直接调用服务，查看是否成功，如果调用成功表示服务接口没有问题
计费说明 计费项 按API调用次数按需计费。 只有调用成功才会计算调用次数，其中200状态码表示调用成功。 费用账单 费用账单可以在费用中心进行查看、导出。 图1 明细账单 账单数据是唯一标准的计费数据，只对用户调用中状态码满足范围内的调用，进行收费。只有调用成功才会计算调用次数，
获取项目ID 从控制台获取项目ID 登录管理控制台。 鼠标移动到右上角的用户名上，在下拉列表中选择“我的凭证”。 在“我的凭证”页面，可以查看用户名、账号名，在项目列表中查看项目。 图1 查看项目ID 多项目时，展开“所属区域”，从“项目ID”列获取子项目ID。 调用API获取项目
调用API报错IVS.0015怎么处理 问题现象 调用人证核身接口时，报错“IVS.0015”。 该报错表示调用的API没有开通。 解决方法 请先登录控制台开通所需的服务。 如已开通，检查开通服务区域和实际调用的API的区域是否一致。 图1 检查区域信息 父主题： 错误码类
终端节点 终端节点即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 人证核身的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。 表1 人证核身的终端节点 区域名称 区域 终端节点（Endpoint） 部署服务 华北
获取OBS中对象URL OBS服务简介 对象存储服务（Object Storage Service，OBS）是一个基于对象的海量存储服务，为客户提供海量、安全、高可靠、低成本的数据存储能力。 创建OBS桶 登录对象存储服务控制台。 左侧导航栏选择“桶列表”，在右上角选择“创建桶”。
IdcardResult 身份证图像文字识别结果结构体。 表1 结构体说明 参数 类型 描述 name String 身份证上识别的名称。 number String 身份证号。 sex String 性别。 birth String 出生日期。 ethnicity String
权限管理 如果您需要对华为云上购买的IVS资源，为企业中的员工设置不同的访问权限，以达到不同员工之间的权限隔离，您可以使用统一身份认证服务（Identity and Access Management，简称IAM）进行精细的权限管理。该服务提供用户身份认证、权限分配、访问控制等功能
开始使用 动作活体检测视频采集要求 表1 动作活体检测视频检测要求 活体检测动作 动作示例 视频动作说明 左摇头 √，左摇头幅度正常。 ×，左摇头幅度过大，超出画面。 右摇头 √，右摇头幅度正常。 ×，右摇头幅度过大，超出画面。 点头 √，点头幅度正常 ×，点头幅度过大，超出画面。
状态码 HTTP 状态码为三位数，分成五个类别：1xx：相关信息；2xx：操作成功；3xx：重定向；4xx：客户端错误；5xx：服务器错误。 状态码如下所示。 状态码 编码 状态说明 100 Continue 继续请求。 这个临时响应用来通知客户端，它的部分请求已经被服务器接收，且仍未被拒绝
错误码 调用接口出错后，将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。当调用出错时，HTTPS请求返回一个 4xx 或 5xx 的 HTTPS状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系华为云客服，并提供错误码，以便尽快帮您解决问题
API概览 人证核身服务根据不同场景提供多种API。 表1 接口说明 API 说明 标准版（三要素） 使用姓名、身份证号码、人脸图片三要素进行身份审核。 证件版（二要素） 使用姓名、身份证号码二要素进行身份审核。
开通人证核身服务 IVS服务提供的开通方式有以下两种，用户可以任选其一进行开通服务。 按需计费开通服务 登录IVS服务控制台。 选择需要使用的服务，在操作列单击“开通服务”，此时的计费方式采用按需计费。 图1 开通服务 服务开通成功后，开通状态将显示为“已开通”。 IVS服务开通后
构造请求 本节介绍REST API请求的组成，并以调用人证核身（三要素）接口为例说明如何调用API，该API获取用户的Token，Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos
SDK简介 人证核身服务端SDK是对人证核身提供的REST API进行的封装，您可以直接继承服务端从而实现对人证核身服务的快速操作。 接口与API对应关系 表1 接口与API对应关系 接口 API 人证核身标准版（三要素） POST https://{endpoint}/v2.0/
创建IAM用户并授权使用IVS 如果您需要对您所拥有的IVS进行精细的权限管理，您可以使用统一身份认证服务（Identity and Access Management，简称IAM），通过IAM，您可以： 根据企业的业务组织，在您的华为云账号中，给企业中不同职能部门的员工创建IAM
入门实践 当您完成了调用API、调用SDK基本操作后，可以根据自身的业务需求使用IVS提供的入门实践。 表1 常用最佳实践 实践 描述 活体人证核身 该实践基于于华为云人证核身服务IVS和人脸识别服务FRS构建，通过动作活体检测判断操作用户是否为真人，并将检测结果与用户身份证信息关联起来
校验信息说明 表1 验证信息 检验代码 检验结果 检验信息 说明 1000 valid Successful certification 认证成功。 2001 invalid Inconsistent identity information 认证信息不一致，即姓名与身份证号码不一致
调用API实现人证核身证件版（二要素） 本章节通过Postman调用人证核身证件版（二要素）API为例，帮助您快速体验并熟悉IVS服务的使用方法。 使用IVS服务API的详细步骤如下所示： 步骤1：开通服务 步骤2：配置环境 步骤3：获取API凭证 步骤4：Token认证鉴权 步骤
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
