检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 人证核身服务根据不同场景提供多种API。 表1 接口说明 API 说明 标准版（三要素） 使用姓名、身份证号码、人脸图片三要素进行身份审核。 证件版（二要素） 使用姓名、身份证号码二要素进行身份审核。
准备数据 数据要求 受技术与成本多种因素制约，IVS服务存在一些约束限制。 API只支持“华北-北京四”区域。 只支持中国大陆身份证的识别。 只支持JPG格式，图片中人像需无遮挡。 图像数据，base64编码，要求base64编码后大小不超过4MB。 图像各边的像素大小在300到8000px之间。
Go SDK 本章节介绍人证核身服务Go SDK，您可以参考本章节进行快速集成开发。 准备工作 注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。 已开通人证核身服务。如未开通，请登录人证核身管理控制台开通所需服务。 已具备开发环境，Go SDK 支持 go 1
在线调试 API Explorer在线调试工具提供API的检索、调试、代码示例生成功能。同时，集成开发环境CloudIDE，可完成代码的构建、调试、运行。 本章节以证件版（二要素）API为例，介绍如何使用API Explorer调试API。 前提条件 注册华为账号并开通华为云，并
调用API实现人证核身证件版（二要素） 本章节通过Postman调用人证核身证件版（二要素）API为例，帮助您快速体验并熟悉IVS服务的使用方法。 使用IVS服务API的详细步骤如下所示： 步骤1：开通服务 步骤2：配置环境 步骤3：Token认证鉴权 步骤4：调用服务 准备工作
开始使用 动作活体检测视频采集要求 表1 动作活体检测视频检测要求 活体检测动作 动作示例 视频动作说明 左摇头 √，左摇头幅度正常。 ×，左摇头幅度过大，超出画面。 右摇头 √，右摇头幅度正常。 ×，右摇头幅度过大，超出画面。 点头 √，点头幅度正常 ×，点头幅度过大，超出画面。
校验信息说明 表1 验证信息 检验代码 检验结果 检验信息 说明 1000 valid Successful certification 认证成功。 2001 invalid Inconsistent identity information 认证信息不一致，即姓名与身份证号码不一致。
调用SDK实现人证核身证件版（二要素） 人证核身服务软件开发工具包（IVS SDK）是对人证核身服务提供的REST API进行的封装，以简化用户的开发工作。 人证核身证件版（二要素）API为例，介绍如何使用IVS Python SDK。 使用IVS SDK的详细步骤如下所示： 步骤1：开通服务
错误码 调用接口出错后，将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。当调用出错时，HTTPS请求返回一个 4xx 或 5xx 的 HTTPS状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系华为云客服，并提供错误码，以便尽快帮您解决问题。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
