# 人证核身服务 IVS

> 实现对身份真实性的精准核验

## 产品介绍

- [什么是人证核身](https://support.huaweicloud.com/productdesc-ivs/ivs_01_0001.md): 人证核身服务（Identity Verification Solution，简称IVS），是指通过用户的身份证信息、人脸图片，与权威数据库进行比对，进而实现身份验证。当前，人证核身提供以下子功能：标准版（三要素）使用姓名、身份证号码、人脸图像三要素进行匹配核验。使用姓名、身份证号码、人脸图像三要素进行匹配核验。证件版（二要素）使用姓名、身
- [应用场景](https://support.huaweicloud.com/productdesc-ivs/ivs_01_0002.md): 身份核验是人工智能领域最重要的应用之一，可广泛使用于金融保险、政务民生、互联网（含手机App）实名认证、O2O服务监管、网络/手机游戏防沉迷监管、访客登记、密码保护等领域。银行、互联网金融、证券、保险公司等金融机构对用户身份真实性的要求很高，传统渠道主要依赖用户上门进行人工核验身份，继而完成开户、交易等行为，不仅费时费力且用户体验较差。华
- [产品功能](https://support.huaweicloud.com/productdesc-ivs/ivs_01_0014.md): 使用姓名、身份证号码、人脸图片（或人脸视频）三要素进行身份审核。身份验证时，传入的数据为人脸图片、身份证信息。提取身份证信息时，可以使用身份证正反面图片，也可以直接输入姓名、身份证号文本。使用姓名、身份证号码二要素进行身份核验。身份验证时，传入的数据为身份证信息。提取身份证信息时，可以使用身份证正反面图片，也可以直接输入姓名、身份证号文本
- [计费说明](https://support.huaweicloud.com/productdesc-ivs/ivs_01_0003.md): 按API调用次数按需计费。只有调用成功才会计算调用次数，其中200状态码表示调用成功。费用账单可以在费用中心进行查看、导出。账单数据是唯一标准的计费数据，只对用户调用中状态码满足范围内的调用，进行收费。只有调用成功才会计算调用次数，其中返回的200状态码表示调用成功，调用失败不计费。账单数据与IVS控制台API调用量，会因时间差原因，导致
- [与其他云服务的关系](https://support.huaweicloud.com/productdesc-ivs/ivs_01_0004.md): 统一身份认证（Identity and Access Management，简称IAM）服务，IAM为人证核身提供了用户认证和鉴权功能。企业项目管理（Enterprise Project Management Service，简称“EPS”），为客户提供与企业组织架构和业务管理模型匹配的云治理平台。以面向企业资源管理为出发点，帮助企业以公
- [约束与限制](https://support.huaweicloud.com/productdesc-ivs/ivs_01_0006.md): 只支持华北-北京四区域。只支持中国大陆身份证的识别。支持港澳台居住证核验，证件信息需文本输入只支持JPG格式，图片中人像需无遮挡。图像数据，base64编码，要求base64编码后大小不超过4MB。图像各边的像素大小在300到8000px之间。图像中身份证区域有效占比超过15%，保证整张身份证内容及其边缘包含在图像内。支持图像中身份证要求
- [责任共担](https://support.huaweicloud.com/productdesc-ivs/ivs_01_0016.md): 华为云秉承“将公司对网络和业务安全性保障的责任置于公司的商业利益之上”。针对层出不穷的云安全挑战和无孔不入的云安全威胁与攻击，华为云在遵从法律法规业界标准的基础上，以安全生态圈为护城河，依托华为独有的软硬件优势，构建面向不同区域和行业的完善云服务安全保障体系。与传统的本地数据中心相比，云计算的运营方和使用方分离，提供了更好的灵活性和控制力
- [身份认证与访问控制](https://support.huaweicloud.com/productdesc-ivs/ivs_01_0017.md): 用户访问IVS的方式有多种，包括IVS控制台、API、SDK，无论访问方式封装成何种形式，其本质都是通过IVS提供的REST风格的API接口进行请求。IVS的接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。Token认证：通过Token认证调用请求。AK/SK认证：通过AK（Access Key ID）/SK（Secret Acc
- [数据保护技术](https://support.huaweicloud.com/productdesc-ivs/ivs_01_0018.md): IVS服务处理以下类型的数据：IVS输入数据，包括图像、视频和文本。IVS结果，包括身份认证结果信息。IVS输入数据，包括图像、视频和文本。IVS结果，包括身份认证结果信息。IVS通过多种数据保护手段和特性，保障客户在使用IVS服务时数据安全。
- [服务韧性](https://support.huaweicloud.com/productdesc-ivs/ivs_01_0019.md): 华为云数据中心按规则部署在全球各地，所有数据中心都处于正常运营状态，无一闲置。数据中心互为灾备中心，如一地出现故障，系统在满足合规政策前提下自动将客户应用和数据转离受影响区域，保证业务的连续性。为了减少由硬件故障、自然灾害或其他灾难带来的服务中断，华为云为所有数据中心提供灾难恢复计划。IVS提供三级可靠性架构，通过AZ之间容灾、AZ内实例
- [监控安全风险](https://support.huaweicloud.com/productdesc-ivs/ivs_01_0020.md): IVS提供基于云监控服务CES的监控能力，帮助用户监控账号下的IVS服务API，执行自动实时监控、告警和通知操作。用户可以实时掌握API所产生的调用成功次数、调用失败次数等信息。关于IVS支持的监控指标，以及如何创建监控告警规则等内容，请参见监控。

## 快速入门

- [IVS服务使用简介](https://support.huaweicloud.com/qs-ivs/ivs_08_0001.md): 人证核身服务（Identity Verification Solution，简称IVS），是指通过用户的身份证信息、人脸图片，与权威数据库进行比对，进而实现身份验证。服务以开放API（Application Programming Interface，应用程序编程接口）的方式提供身份验证能力。用户调用API接口需要具备一定的编程开发基础，
- [调用API实现人证核身证件版（二要素）](https://support.huaweicloud.com/qs-ivs/ivs_08_0002.md): 本章节通过Postman调用人证核身证件版（二要素）API为例，帮助您快速体验并熟悉IVS服务的使用方法。使用IVS服务API的详细步骤如下所示：步骤1：开通服务步骤2：配置环境步骤3：获取API凭证步骤4：Token认证鉴权步骤5：调用服务账号已完成实名认证，且不能处于欠费或冻结状态。登录人证核身服务控制台。选择需要使用的服务，在操作列
- [调用SDK实现人证核身证件版（二要素）](https://support.huaweicloud.com/qs-ivs/ivs_08_0003.md): 人证核身服务软件开发工具包（IVS SDK）是对人证核身服务提供的REST API进行的封装，以简化用户的开发工作。人证核身证件版（二要素）API为例，介绍如何使用IVS Python SDK。使用IVS SDK的详细步骤如下所示：步骤1：开通服务步骤2：安装SDK步骤3：获取示例代码步骤4：调用服务账号完成实名认证，且不能处于欠费或冻结
- [入门实践](https://support.huaweicloud.com/qs-ivs/ivs_08_0004.md): 当您完成了调用API、调用SDK基本操作后，可以根据自身的业务需求使用IVS提供的入门实践。

## 用户指南

- [使用流程简介](https://support.huaweicloud.com/usermanual-ivs/ivs_10_0001.md): 人证核身是指通过用户的身份证信息、人脸图片，与权威数据库进行比对，进而实现身份验证。用户需要具备编程能力，熟悉Java、Python、iOS、Android、Node.js编程语言。IVS服务需要用户通过调用API接口，实现身份信息核验。API会返回JSON格式的识别结果，用户需要通过编码将识别结果对接到业务系统中。关于人证核身服务的相关
- [开通人证核身服务](https://support.huaweicloud.com/usermanual-ivs/ivs_10_0002.md): IVS服务提供的开通方式有以下两种，用户可以任选其一进行开通服务。登录IVS服务控制台。选择需要使用的服务，在操作列单击开通服务，此时的计费方式采用按需计费。开通服务服务开通成功后，开通状态将显示为“已开通”。服务开通成功后，开通状态将显示为“已开通”。IVS服务开通后，可在控制台进行关闭。开通服务时，计费规则默认为“按需计费”。只有调用
- [准备数据](https://support.huaweicloud.com/usermanual-ivs/ivs_10_0003.md): 受技术与成本多种因素制约，IVS服务存在一些约束限制。API只支持“华北-北京四”区域。只支持中国大陆身份证的识别。只支持JPG格式，图片中人像需无遮挡。图像数据，base64编码，要求base64编码后大小不超过4MB。图像各边的像素大小在300到8000px之间。图像中身份证区域有效占比超过15%，保证整张身份证内容及其边缘包含在图像
- [在线调试](https://support.huaweicloud.com/usermanual-ivs/ivs_10_0005.md): API Explorer在线调试工具提供API的检索、调试、代码示例生成功能。同时，集成开发环境CloudIDE，可完成代码的构建、调试、运行。本章节以证件版（二要素）API为例，介绍如何使用API Explorer调试API。注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费、冻结、被注销等异常状态。已开通人证核身服务。登录AP
- [本地调用](https://support.huaweicloud.com/usermanual-ivs/ivs_10_0006.md): 本章节以证件版（二要素）API为例，介绍如何使用IVS Python SDK在本地进行开发。该接口使用姓名、身份证号码二要素进行身份审核，并将识别结果以JSON格式返回给用户。人证核身成功时，会返回校验通过信息；人证核身失败时，会返回校验失败的具体原因。注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费、冻结、被注销等异常状态。已
- [统计API使用量](https://support.huaweicloud.com/usermanual-ivs/ivs_10_0011.md): IVS服务控制台支持查看API的总调用量、调用成功量、调用失败量。如果您购买了套餐包，可在“套餐包管理”页面，查看已有的套餐包及使用详情。套餐包费用扣减规则请参见“产品介绍 > 计费说明”。
- [关闭服务](https://support.huaweicloud.com/usermanual-ivs/ivs_10_0012.md): IVS服务开通后，如不使用，可登录控制台进行关闭。如果您是主账户，也可以控制子用户的服务开通、关闭状态。
- [人证核身的监控指标](https://support.huaweicloud.com/usermanual-ivs/ivs_10_0014.md): 本节定义了人证核身服务上报云监控服务的监控指标的命名空间、监控指标列表和维度定义，用户可以通过云监控服务提供管理控制台或API接口来检索IVS服务产生的监控指标和告警信息。SYS.IVS
- [查看监控指标](https://support.huaweicloud.com/usermanual-ivs/ivs_10_0015.md): 登录云监控服务（CES）控制台。在左侧导航栏中选择“云服务监控 > 人证核身”。单击监控列表“操作”列的“查看监控指标”，进入指标监控页面。在监控区域，您可以通过选择时长，查看对应时间的监控数据。查看监控指标在监控区域，您可以通过选择时长，查看对应时间的监控数据。
- [权限管理](https://support.huaweicloud.com/usermanual-ivs/ivs_10_0017.md): 如果您需要对华为云上购买的IVS资源，为企业中的员工设置不同的访问权限，以达到不同员工之间的权限隔离，您可以使用统一身份认证服务（Identity and Access Management，简称IAM）进行精细的权限管理。该服务提供用户身份认证、权限分配、访问控制等功能，可以帮助您安全的控制华为云资源的访问。如果华为云账号已经能满足您的
- [创建IAM用户并授权使用IVS](https://support.huaweicloud.com/usermanual-ivs/ivs_10_0018.md): 如果您需要对您所拥有的IVS进行精细的权限管理，您可以使用统一身份认证服务（Identity and Access Management，简称IAM），通过IAM，您可以：根据企业的业务组织，在您的华为云账号中，给企业中不同职能部门的员工创建IAM用户，让员工拥有唯一安全凭证，并使用IVS资源。根据企业用户的职能，设置不同的访问权限，以达
- [IVS自定义策略](https://support.huaweicloud.com/usermanual-ivs/ivs_10_0019.md): 如果系统预置的权限，不满足您的授权要求，可以创建自定义策略。自定义策略中可以添加的授权项（Action）请参见权限管理。目前华为云支持以下两种方式创建自定义策略：可视化视图创建自定义策略：无需了解策略语法，按可视化视图导航栏选择云服务、操作、资源、条件等策略内容，可自动生成策略。JSON视图创建自定义策略：可以在选择策略模板后，根据具体需
- [应用场景简介](https://support.huaweicloud.com/usermanual-ivs/ivs_10_0021.md): IVS支持通过企业项目管理（EPS）对不同用户组和用户的资源使用，进行分账。企业可以根据组织架构规划不同的企业项目，并为每个企业项目设置拥有不同权限的用户组和用户，多个企业项目之间相互独立，资源分开结算。企业账号可申请开通企业项目。账号需要进行企业实名认证。如果企业账号注册成为华为云合作伙伴，将无法进入企业项目管理页面。开通企业项目后，企
- [创建企业项目](https://support.huaweicloud.com/usermanual-ivs/ivs_10_0022.md): 创建企业项目的用户必须是管理员，或在IAM侧已被授予EPS FullAccess权限的用户。企业账号可申请开通企业项目。账号需要进行企业实名认证。如果企业账号注册成为华为云合作伙伴，将无法进入企业项目管理页面。创建IAM用户步骤请参见创建IAM用户并授权使用IVS。登录控制台，单击界面右上方的“企业 > 项目管理”。屏幕分辨率低的情况下单
- [企业项目财务管理](https://support.huaweicloud.com/usermanual-ivs/ivs_10_0023.md): 开通了企业项目的客户，可以按企业项目查看各个企业项目的月度消费汇总、消费明细、产品费用走势和费用分布。进入项目管理的“企业项目管理”页面，单击企业项目操作列的“查看消费 ”，查看各企业项目的费用信息。

## SDK参考

- [SDK简介](https://support.huaweicloud.com/sdkreference-ivs/ivs_07_0001.md): 人证核身服务端SDK是对人证核身提供的REST API进行的封装，您可以直接继承服务端从而实现对人证核身服务的快速操作。
- [Java SDK](https://support.huaweicloud.com/sdkreference-ivs/ivs_07_0002.md): 本章节介绍人证核身服务Java SDK，您可以参考本章节进行快速集成开发。注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。已开通人证核身服务。如未开通，请登录人证核身管理控制台开通所需服务。已具备开发环境，支持Java JDK 1.8 及其以上版本。登录“我的凭证 > 访问密钥”页面，获取Access Key（AK）
- [Python SDK](https://support.huaweicloud.com/sdkreference-ivs/ivs_07_0003.md): 本章节介绍人证核身服务Python SDK，您可以参考本章节进行快速集成开发。注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。已开通人证核身服务。如未开通，请登录人证核身管理控制台开通所需服务。已具备开发环境，支持Python3及以上版本。登录“我的凭证 > 访问密钥”页面，获取Access Key（AK）和Secr
- [Go SDK](https://support.huaweicloud.com/sdkreference-ivs/ivs_07_0004.md): 本章节介绍人证核身服务Go SDK，您可以参考本章节进行快速集成开发。注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。已开通人证核身服务。如未开通，请登录人证核身管理控制台开通所需服务。已具备开发环境，Go SDK 支持 go 1.14 及以上版本，可执行 go version 检查当前 Go 的版本信息。登录“我的
- [.NET SDK](https://support.huaweicloud.com/sdkreference-ivs/ivs_07_0005.md): 本章节介绍.NET SDK，您可以参考本章节进行快速集成开发。注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。已具备开发环境，.NET SDK 适用于.NET Standard 2.0 及其以上版本；C# 4.0 及其以上版本。登录“我的凭证 > 访问密钥”页面，获取Access Key（AK）和Secret Acc
- [Node.js SDK](https://support.huaweicloud.com/sdkreference-ivs/ivs_07_0006.md): 本章节介绍新版Node.js SDK，您可以参考本章节进行快速集成开发。注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。已具备开发环境，支持Node 10.16.1 及其以上版本。登录“我的凭证 > 访问密钥”页面，获取Access Key（AK）和Secret Access Key（SK）。获取AK、SK登录“我的
- [PHP SDK](https://support.huaweicloud.com/sdkreference-ivs/ivs_07_0007.md): 本章节介绍新版PHP SDK，您可以参考本章节进行快速集成开发。注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。已具备开发环境，PHP 5.6 及以上版本，可执行 php --version 检查当前的版本信息。登录“我的凭证 > 访问密钥”页面，获取Access Key（AK）和Secret Access Key（
- [C++ SDK](https://support.huaweicloud.com/sdkreference-ivs/ivs_07_0008.md): 本章节介绍新版C++ SDK，您可以参考本章节进行快速集成开发。注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。已具备开发环境，支持 C++ 14 及以上版本，要求安装 CMake 3.10 及以上版本。登录“我的凭证 > 访问密钥”页面，获取Access Key（AK）和Secret Access Key（SK）。

## API参考

- [概述](https://support.huaweicloud.com/api-ivs/ivs_02_0002.md): 人证核身服务（Identity Verification Solution，简称IVS）是结合人脸识别、文字识别等技术，对用户身份进行真实性核验。人证核身服务以开放API的方式提供给用户，您可以根据本文档提供的API来使用服务。在调用人证核身服务API之前，请确保已经充分了解人证核身服务相关概念，详细信息请参见产品介绍。
- [调用说明](https://support.huaweicloud.com/api-ivs/ivs_02_0003.md): 人证核身提供了 REST（Representational State Transfer）风格 API，支持您通过 HTTPS 请求调用，调用方法请参见如何调用API。该服务旨在通过技术手段实现人员身份信息与证件信息的精准核验，广泛应用于金融开户、政务办理、在线平台注册等需要确认用户真实身份的场景，为业务安全提供基础保障，助力企业与开发者
- [终端节点](https://support.huaweicloud.com/api-ivs/ivs_02_0004.md): 终端节点即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。人证核身的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。
- [约束与限制](https://support.huaweicloud.com/api-ivs/ivs_02_0005.md): 只支持华北-北京四区域。只支持中国大陆身份证的识别。只支持JPG格式，图片中人像需无遮挡。图像数据，base64编码，要求base64编码后大小不超过4MB。图像各边的像素大小在300到8000px之间。图像中身份证区域有效占比超过15%，保证整张身份证内容及其边缘包含在图像内。支持图像中身份证要求水平放置。目前支持检测视频文件，或视频的
- [基本概念](https://support.huaweicloud.com/api-ivs/ivs_02_0006.md): 账号用户注册华为云时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用他们进行日常管理工作。用户注册华为云时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账
- [API概览](https://support.huaweicloud.com/api-ivs/ivs_02_0007.md): 人证核身服务根据不同场景提供多种API。
- [申请服务](https://support.huaweicloud.com/api-ivs/ivs_02_0009.md): 正式使用服务之前，必须先申请开通服务，下面是相关服务申请的步骤。首次使用服务时，需要先申请开通该服务。服务只需要开通一次即可，后面使用时无需再次申请。如未开通服务，调用服务时会提示IVS.0015报错，请在调用服务前先进入控制台开通服务，并注意开通服务区域与调用服务的区域保持一致。登录人证核身服务控制台。选择需要使用的服务，在操作列单击开
- [构造请求](https://support.huaweicloud.com/api-ivs/ivs_02_0010.md): 本节介绍REST API请求的组成，并以调用人证核身（三要素）接口为例说明如何调用API，该API获取用户的Token，Token可以用于调用其他API时鉴权。您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987 。请求URI由如下部分组成。{URI-sch
- [认证鉴权](https://support.huaweicloud.com/api-ivs/ivs_02_0011.md): 调用接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。Token认证：通过Token认证调用请求。AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key)加密调用请求。需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。关于Token有效期的详细说明请参见获取IAM用户Token（使
- [返回结果](https://support.huaweicloud.com/api-ivs/ivs_02_0012.md): 请求发送以后，您会收到响应，包含状态码、响应消息头和消息体。状态码是一组数字代码，状态码表示了请求响应的状态，如果调用后返回状态码为2xx，则表示调用成功。完整的状态码列表请参见状态码。对应请求消息头，响应同样也有消息头，如Content-type。例如表1所示。响应消息体通常以结构化格式返回，与响应消息头中Content-type对应，
- [使用身份证图片、人脸图片验证 - DetectStandardByIdCardImage](https://support.huaweicloud.com/api-ivs/ivs_02_0025.md): 使用身份证正反面图片提取姓名和身份证号码，与人脸图片进行三要素身份审核。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要
- [使用身份证文本、人脸图片验证 - DetectStandardByNameAndId](https://support.huaweicloud.com/api-ivs/ivs_02_0026.md): 使用姓名、身份证号文本和人脸图片进行三要素身份审核。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项
- [使用身份证图片、人脸视频验证 - DetectStandardByVideoAndIdCardImage](https://support.huaweicloud.com/api-ivs/ivs_02_0027.md): 从身份证正反面图片中提取姓名和身份证号码，并对视频做活体检测后提取人脸图片，以此进行三要素身份审核。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用
- [使用身份证文本、人脸视频验证 - DetectStandardByVideoAndNameAndId](https://support.huaweicloud.com/api-ivs/ivs_02_0028.md): 使用姓名、身份证号文本，并对视频做活体检测后提取人脸图片，以此进行三要素身份审核。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，
- [使用身份证文本验证 - DetectExtentionByNameAndId](https://support.huaweicloud.com/api-ivs/ivs_02_0029.md): 使用姓名、身份证号码二要素进行身份审核。身份验证时，传参数据为姓名、身份证号文本。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，
- [使用身份证图片验证 - DetectExtentionByIdCardImage](https://support.huaweicloud.com/api-ivs/ivs_02_0030.md): 使用姓名、身份证号码二要素进行身份审核。身份验证时，传参数据为身份证正反面图片。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具
- [校验信息说明](https://support.huaweicloud.com/api-ivs/ivs_02_0017.md): 由于历史原因，公安部门在办理身份证登记身份信息时，使用了微软或其他输入法，将生僻字以PUA编码形式记录在了公安数据库中。随着信息化发展，这些生僻字以新的编码被国家标准GB18030收录。如今，在手机及通用计算机上都是使用新的编码输入和显示这些生僻字，但由于实名认证时公安系统是根据汉字编码进行比较，而这些生僻字PUA编码和GB18030编码
- [IdcardResult](https://support.huaweicloud.com/api-ivs/ivs_02_0018.md): 身份证图像文字识别结果结构体。
- [状态码](https://support.huaweicloud.com/api-ivs/ivs_02_0020.md): HTTP 状态码为三位数，分成五个类别：1xx：相关信息；2xx：操作成功；3xx：重定向；4xx：客户端错误；5xx：服务器错误。状态码如下所示。
- [错误码](https://support.huaweicloud.com/api-ivs/ivs_02_0021.md): 调用接口出错后，将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。当调用出错时，HTTPS请求返回一个 4xx 或 5xx 的 HTTPS状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系华为云客服，并提供错误码，以便尽快帮您解决问题。当接口调用出错时，会返回错误码及错误信息说明，错误响
- [获取项目ID](https://support.huaweicloud.com/api-ivs/ivs_02_0022.md): 登录管理控制台。鼠标移动到右上角的用户名上，在下拉列表中选择我的凭证。在我的凭证页面，可以查看用户名、账号名，在项目列表中查看项目。查看项目ID多项目时，展开所属区域，从项目ID列获取子项目ID。多项目时，展开所属区域，从项目ID列获取子项目ID。获取项目ID的接口为GET https://{endpoint}/v3/projects，其
- [获取账号ID](https://support.huaweicloud.com/api-ivs/ivs_02_0023.md): 在调用接口的时候，部分URL中需要填入账号ID（domain-id），所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下：登录管理控制台。单击用户名，在下拉列表中单击我的凭证。在我的凭证页面的项目列表中查看账号ID。查看账号ID在我的凭证页面的项目列表中查看账号ID。查看账号ID
- [修订记录](https://support.huaweicloud.com/api-ivs/ivs_02_0024.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。

## 最佳实践

- [方案概述](https://support.huaweicloud.com/bestpractice-ivs/ivs_09_0002.md): 该解决方案基于华为云人证核身服务IVS和人脸识别服务FRS构建，通过动作活体检测判断操作用户是否为真人，并将检测结果与用户身份证信息关联起来，使用人证核身技术，实现对用户身份真实性的核验。适用于金融保险、物流快递、游戏、互联网、差旅住宿等多种行业的账号实名注册、实名认证登录、密码找回和保护、实人核身验证等场景。部署该解决方案会使用到如下资
- [资源与成本规划](https://support.huaweicloud.com/bestpractice-ivs/ivs_09_0003.md): 该解决方案主要部署如下资源，需要的产品列表和配置示例如表1、表2所示，以下花费仅供参考。本文提供的成本预估费用仅供参考，资源的实际费用以华为云管理控制台显示为准。
- [准备工作](https://support.huaweicloud.com/bestpractice-ivs/ivs_09_0005.md): 开通后，默认为按需计费。开通“人证核身标准版（三要素）”开通后，默认为按需计费。开通“动作活体检测”
- [自动化部署步骤](https://support.huaweicloud.com/bestpractice-ivs/ivs_09_0006.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。
- [开始使用](https://support.huaweicloud.com/bestpractice-ivs/ivs_09_0007.md): 用户可以通过API网关服务提供的发布API功能，将调试成功的解决方案，发布为API，基于该API进行二次开发，并对接到业务系统中。
- [快速卸载](https://support.huaweicloud.com/bestpractice-ivs/ivs_09_0008.md): 在进行一键卸载之前，需要先删除该方案创建的委托。
- [获取OBS中对象URL](https://support.huaweicloud.com/bestpractice-ivs/ivs_09_0010.md): 对象存储服务（Object Storage Service，OBS）是一个基于对象的海量存储服务，为客户提供海量、安全、高可靠、低成本的数据存储能力。创建好的OBS桶，将显示在“桶列表”页。创建OBS桶使用完成后，建议删除桶内数据和OBS桶，避免产生额外的数据存储费用。

## 常见问题

- [如何开通服务，计费规则](https://support.huaweicloud.com/ivs_faq/ivs_03_0002.md): 登录人证核身服务控制台。选择需要使用的服务，在操作列单击开通服务。开通服务服务开通成功后，开通状态显示已开通。按需计费按需计费是指按照API调用次数阶梯价格计费，按月累计，一个自然月后次数清零重新累计。具体计费价格请参见人证核身价格计算器。只有调用成功（返回状态码200）才会计算调用次数，未用完的免费调用次数不流转到下一个月。计费规则：调
- [是否能退订服务，退订套餐包](https://support.huaweicloud.com/ivs_faq/ivs_03_0003.md): 服务开通后，不支持退订，不使用则不计费。如果购买了套餐包，已购买套餐包不支持退订，购买前请确认。
- [如何开通服务，计费规则](https://support.huaweicloud.com/ivs_faq/ivs_03_0002.md): 登录人证核身服务控制台。选择需要使用的服务，在操作列单击开通服务。开通服务服务开通成功后，开通状态显示已开通。按需计费按需计费是指按照API调用次数阶梯价格计费，按月累计，一个自然月后次数清零重新累计。具体计费价格请参见人证核身价格计算器。只有调用成功（返回状态码200）才会计算调用次数，未用完的免费调用次数不流转到下一个月。计费规则：调
- [是否能退订服务，退订套餐包](https://support.huaweicloud.com/ivs_faq/ivs_03_0003.md): 服务开通后，不支持退订，不使用则不计费。如果购买了套餐包，已购买套餐包不支持退订，购买前请确认。
- [查看API使用次数](https://support.huaweicloud.com/ivs_faq/ivs_03_0005.md): 登录人证核身服务控制台。在云上服务管理页面，查看API的使用量和套餐包的使用量。API使用量统计
- [是否支持生僻字识别，少数民族字体识别](https://support.huaweicloud.com/ivs_faq/ivs_03_0006.md): 支持部分生僻字识别。不支持少数民族语言文字识别。
- [接口的并发是多少](https://support.huaweicloud.com/ivs_faq/ivs_03_0007.md): 人证核身标准版（三要素）、人证核身证件版（二要素）默认并发为10qps。
- [通过js将图片转成base64编码](https://support.huaweicloud.com/ivs_faq/ivs_03_0016.md): 下方示例代码通过js将图片转换成base64编码。功能如下：在页面加载完成后，给id为imgUpload的文件输入框添加了一个onchange事件监听器，当用户选择了一张图片后，就调用getBase64函数。getBase64函数接收一个文件对象作为参数，然后创建一个FileReader对象，用来读取文件的内容。FileReader对象有
- [通过python将图片转成base64编码](https://support.huaweicloud.com/ivs_faq/ivs_03_0017.md): 下方示例代码以Python为例，介绍如何将d:\demo.jpg图片转换成base64编码。您也可以使用在线的图片转base64工具。
- [查看API使用次数](https://support.huaweicloud.com/ivs_faq/ivs_03_0005.md): 登录人证核身服务控制台。在云上服务管理页面，查看API的使用量和套餐包的使用量。API使用量统计
- [是否支持生僻字识别，少数民族字体识别](https://support.huaweicloud.com/ivs_faq/ivs_03_0006.md): 支持部分生僻字识别。不支持少数民族语言文字识别。
- [接口的并发是多少](https://support.huaweicloud.com/ivs_faq/ivs_03_0007.md): 人证核身标准版（三要素）、人证核身证件版（二要素）默认并发为10qps。
- [通过js将图片转成base64编码](https://support.huaweicloud.com/ivs_faq/ivs_03_0016.md): 下方示例代码通过js将图片转换成base64编码。功能如下：在页面加载完成后，给id为imgUpload的文件输入框添加了一个onchange事件监听器，当用户选择了一张图片后，就调用getBase64函数。getBase64函数接收一个文件对象作为参数，然后创建一个FileReader对象，用来读取文件的内容。FileReader对象有
- [通过python将图片转成base64编码](https://support.huaweicloud.com/ivs_faq/ivs_03_0017.md): 下方示例代码以Python为例，介绍如何将d:\demo.jpg图片转换成base64编码。您也可以使用在线的图片转base64工具。
- [调用API报错IVS.0015怎么处理](https://support.huaweicloud.com/ivs_faq/ivs_03_0009.md): 调用人证核身接口时，报错“IVS.0015”。该报错表示调用的API没有开通。请先登录控制台开通所需的服务。如已开通，检查开通服务区域和实际调用的API的区域是否一致。检查区域信息
- [改名字导致的校验不通过怎么处理](https://support.huaweicloud.com/ivs_faq/ivs_03_0010.md): 服务依赖于国家权威数据库。迁移户口、军人转业、出国等行为都会影响该数据库，数据时效依赖于该数据库自身信息更新情况。
- [APIG.0101报错处理方法](https://support.huaweicloud.com/ivs_faq/ivs_03_0013.md): 访问的API不存在或尚未在环境中发布：The API does not exist or has not been published in the environment.请检查API的URL是否拼写正确。检查URI中的区域信息是否和调用服务配置的终端节点是否对应。检查区域信息HTTP请求方法（POST，GET等）是否正确。具体的URI
- [APIG.0201报错处理方法](https://support.huaweicloud.com/ivs_faq/ivs_03_0014.md): 如果调用API时返回错误信息与错误码："error_msg":"Backend timeout.","error_code":"APIG.0201"，表示请求超时。您可以尝试以下方案进行解决。使用Postman等工具直接调用服务，查看是否成功，如果调用成功表示服务接口没有问题，请执行如下步骤1和步骤2进行检查：请检查原调用请求是否过于频繁
- [APIG.0301报错处理方法](https://support.huaweicloud.com/ivs_faq/ivs_03_0015.md): 如果在调用API时返回错误信息与错误码："error_msg":"Incorrect IAM authentication information: decrypt token fail","error_code":"APIG.0301"，是因为token解密失败。解决方案：（1）请检查token是否过期。（2）获取token的方法，请求
- [APIG.0307报错处理方法](https://support.huaweicloud.com/ivs_faq/zh-cn_topic_0000001815009902.md): 如果调用API时返回错误信息与错误码："error_msg":"The token must be updated.","error_code":"APIG.0307"，是因为Token失效，需要进行更新。您可以尝试以下方案进行解决。Token有效期为24小时，请使用重新获取Token调用API。检查接口URL中的终端节点是否填写正确。部
- [账密报错“The username or password is wrong.”](https://support.huaweicloud.com/ivs_faq/ivs_03_0018.md): 获取Token时出现“The username or password is wrong.”。请确认近期华为云账号是否有升级为华为账号。当前，如果您通过华为账号入口登录华为云账号，就会指引升级。华为云账号若已升级为华为账号，将不支持获取账号Token。建议您创建一个IAM账户，使用IAM账户获取Token。登录华为云控制台，在右上角用户名
- [调用API报错IVS.0015怎么处理](https://support.huaweicloud.com/ivs_faq/ivs_03_0009.md): 调用人证核身接口时，报错“IVS.0015”。该报错表示调用的API没有开通。请先登录控制台开通所需的服务。如已开通，检查开通服务区域和实际调用的API的区域是否一致。检查区域信息
- [改名字导致的校验不通过怎么处理](https://support.huaweicloud.com/ivs_faq/ivs_03_0010.md): 服务依赖于国家权威数据库。迁移户口、军人转业、出国等行为都会影响该数据库，数据时效依赖于该数据库自身信息更新情况。
- [APIG.0101报错处理方法](https://support.huaweicloud.com/ivs_faq/ivs_03_0013.md): 访问的API不存在或尚未在环境中发布：The API does not exist or has not been published in the environment.请检查API的URL是否拼写正确。检查URI中的区域信息是否和调用服务配置的终端节点是否对应。检查区域信息HTTP请求方法（POST，GET等）是否正确。具体的URI
- [APIG.0201报错处理方法](https://support.huaweicloud.com/ivs_faq/ivs_03_0014.md): 如果调用API时返回错误信息与错误码："error_msg":"Backend timeout.","error_code":"APIG.0201"，表示请求超时。您可以尝试以下方案进行解决。使用Postman等工具直接调用服务，查看是否成功，如果调用成功表示服务接口没有问题，请执行如下步骤1和步骤2进行检查：请检查原调用请求是否过于频繁
- [APIG.0301报错处理方法](https://support.huaweicloud.com/ivs_faq/ivs_03_0015.md): 如果在调用API时返回错误信息与错误码："error_msg":"Incorrect IAM authentication information: decrypt token fail","error_code":"APIG.0301"，是因为token解密失败。解决方案：（1）请检查token是否过期。（2）获取token的方法，请求
- [APIG.0307报错处理方法](https://support.huaweicloud.com/ivs_faq/zh-cn_topic_0000001815009902.md): 如果调用API时返回错误信息与错误码："error_msg":"The token must be updated.","error_code":"APIG.0307"，是因为Token失效，需要进行更新。您可以尝试以下方案进行解决。Token有效期为24小时，请使用重新获取Token调用API。检查接口URL中的终端节点是否填写正确。部
- [账密报错“The username or password is wrong.”](https://support.huaweicloud.com/ivs_faq/ivs_03_0018.md): 获取Token时出现“The username or password is wrong.”。请确认近期华为云账号是否有升级为华为账号。当前，如果您通过华为账号入口登录华为云账号，就会指引升级。华为云账号若已升级为华为账号，将不支持获取账号Token。建议您创建一个IAM账户，使用IAM账户获取Token。登录华为云控制台，在右上角用户名
- [什么是区域与可用区](https://support.huaweicloud.com/ivs_faq/ivs_03_0012.md): 我们用区域和可用区来描述数据中心的位置，您可以在特定的区域、可用区创建资源。区域（Region）：从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属R
- [什么是区域与可用区](https://support.huaweicloud.com/ivs_faq/ivs_03_0012.md): 我们用区域和可用区来描述数据中心的位置，您可以在特定的区域、可用区创建资源。区域（Region）：从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属R