检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
按需计费是指按照API调用次数阶梯价格计费，按月累计，一个自然月后次数清零重新累计。 具体计费价格请参见人证核身价格计算器。 只有调用成功（返回状态码200）才会计算调用次数，未用完的免费调用次数不流转到下一个月。 计费规则：调用次数阶梯计费，按月累计，一个自然月后调用次数清零重新累计。
图1 方案架构图 部署该解决方案会使用到如下资源： API网关：API托管服务， 通过APIG，对外提供人证核身和人脸识别的组合API能力。 函数工作流：用于实现人证核身和人脸识别的组合业务逻辑，并通过APIG对外提供服务。 人脸识别服务：提供动作活体检测功能，判断当前用户是否为真人。
Token有效期为24小时，请使用重新获取Token调用API。 检查接口URL中的终端节点是否填写正确。部署在不同区域间的服务，不可以跨区域调用。如果调用了不同区域的接口，导致判断为Token失效，显示APIG.0307错误码。 父主题： 错误码类
APIG.0301报错处理方法 如果在调用API时返回错误信息与错误码： "error_msg":"Incorrect IAM authentication information: decrypt token fail","error_code":"APIG.0301"，是因为token解密失败。
not been published in the environment. 请检查API的URL是否拼写正确。 检查URI中的区域信息是否和调用服务配置的终端节点是否对应。 图1 检查区域信息 HTTP请求方法（POST，GET等）是否正确。 具体的URI信息请在各接口的API页面查看。
P请求与API调用有一定的了解，想快速体验IVS服务，该方式无需编码，只需要输入相关参数，即可调用API，体验服务应用效果。 通过可视化工具（如curl、Postman）发送请求调用IVS服务API。 如果您是开发工程师，熟悉代码编写，熟悉HTTP请求与API调用，您可以通过po
终端节点 终端节点即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 人证核身的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。 表1 人证核身的终端节点 区域名称 区域 终端节点（Endpoint） 部署服务 华北-北京四
服务开通成功后，开通状态将显示为“已开通”。 购买套餐包后只有调用成功才会计算调用次数，其中返回的200状态码表示调用成功，调用失败不计算次数。详细的计费价格及规则请参见计费说明。 套餐包额度使用完后，会转为按需计费。 如未开通服务，直接调用IVS API会提示IVS.0015报错。
Solution，简称IVS）是结合人脸识别、文字识别等技术，对用户身份进行真实性核验。 人证核身服务以开放API的方式提供给用户，您可以根据本文档提供的API来使用服务。 在调用人证核身服务API之前，请确保已经充分了解人证核身服务相关概念，详细信息请参见产品介绍。 父主题： 使用前必读
获取账号ID 在调用接口的时候，部分URL中需要填入账号ID（domain-id），所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下： 登录管理控制台。 单击用户名，在下拉列表中单击“我的凭证”。 在“我的凭证”页面的项目列表中查看账号ID。 图1 查看账号ID 父主题：
使用流程 使用前必读 用户需要具备编程能力，熟悉Java、Python、iOS、Android、Node.js编程语言。 IVS服务需要用户通过调用API接口，实现身份信息核验。API会返回JSON格式的识别结果，用户需要通过编码将识别结果对接到业务系统中。 关于人证核身服务的相关声明请参见人证核身服务免责声明。
表10 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码，具体请参考错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。 请求示例 使用身份证姓名、号码进行身份核验 POST https://{endpoint}/v2
表11 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码，具体请参考错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。 请求示例 使用身份证正、反面图片进行身份核验 POST https://{endpoint}/v2
表10 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码，具体请参考错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。 请求示例 使用身份证姓名、号码、人脸图片进行人证核验 POST
表11 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码，具体请参考错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。 请求示例 使用身份证正、反面图片、人脸图片进行人证核验 POST
人证核身服务端SDK是对人证核身提供的REST API进行的封装，您可以直接继承服务端从而实现对人证核身服务的快速操作。 接口与API对应关系 表1 接口与API对应关系 接口 API 人证核身标准版（三要素） POST https://{endpoint}/v2.0/ivs-standard
表12 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码，具体请参考错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。 请求示例 使用身份证姓名、号码、人脸视频进行活体人证核验 POST
使用前必读 概述 调用说明 终端节点 约束与限制 基本概念
表13 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码，具体请参考错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。 请求示例 使用身份证正、反面图片、人脸视频进行活体人证核验 POST
错误码类 调用API报错IVS.0015怎么处理 改名字导致的校验不通过怎么处理 APIG.0101报错处理方法 APIG.0201报错处理方法 APIG.0301报错处理方法 APIG.0307报错处理方法 账密报错“The username or password is wrong
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
