检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
修订记录 发布日期 修改说明 2021-08-30 第一次正式发布。
入门实践 当您完成了调用API、调用SDK基本操作后，可以根据自身的业务需求使用IVS提供的入门实践。 表1 常用最佳实践 实践 描述 活体人证核身 该实践基于于华为云人证核身服务IVS和人脸识别服务FRS构建，通过动作活体检测判断操作用户是否为真人，并将检测结果与用户身份证信息
最新动态 本文介绍了人证核身服务IVS各特性版本的功能发布和对应的文档动态，新特性将在各个区域（Region）陆续发布，欢迎体验。 2021年08月 序号 功能名称 功能描述 阶段 相关文档 1 上线人证核身服务 通过用户的身份证信息、人脸图片，与权威数据库进行比对，进而实现身份验证。
API概览 人证核身服务根据不同场景提供多种API。 表1 接口说明 API 说明 标准版（三要素） 使用姓名、身份证号码、人脸图片三要素进行身份审核。 证件版（二要素） 使用姓名、身份证号码二要素进行身份审核。
使用前必读 概述 调用说明 终端节点 约束与限制 基本概念
约束与限制 只支持“华北-北京四”区域。 只支持中国大陆身份证的识别。 支持港澳台居住证核验，证件信息需文本输入 只支持JPG格式，图片中人像需无遮挡。 图像数据，base64编码，要求base64编码后大小不超过4MB。 图像各边的像素大小在300到8000px之间。 图像中身
功能总览 功能总览 全部 三要素人证核身 二要素人证核身 活体人证核身 OBS 2.0支持 三要素人证核身 使用姓名、身份证号码、人脸图片（或人脸视频）三要素进行身份审核。 身份验证时，传入的数据为人脸图片、身份证信息。 提取身份证信息时，可以使用身份证正反面图片，也可以直接输入姓名、身份证号文本。
概述 人证核身服务（Identity Verification Solution，简称IVS）是结合人脸识别、文字识别等技术，对用户身份进行真实性核验。 人证核身服务以开放API的方式提供给用户，您可以根据本文档提供的API来使用服务。 在调用人证核身服务API之前，请确保已经充
使用流程简介 人证核身是指通过用户的身份证信息、人脸图片，与权威数据库进行比对，进而实现身份验证。 使用流程 图1 使用流程 使用前必读 用户需要具备编程能力，熟悉Java、Python、iOS、Android、Node.js编程语言。 IVS服务需要用户通过调用API接口，实现
产品咨询类 如何开通服务，计费规则 是否能退订服务，退订套餐包
错误码 调用接口出错后，将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。当调用出错时，HTTPS请求返回一个 4xx 或 5xx 的 HTTPS状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系华为云客服，并提供错误码，以便尽快帮您解决问题。
应用场景 身份核验是人工智能领域最重要的应用之一，可广泛使用于金融保险、政务民生、互联网（含手机App）实名认证、O2O服务监管、网络/手机游戏防沉迷监管、访客登记、密码保护等领域。 金融、保险行业 银行、互联网金融、证券、保险公司等金融机构对用户身份真实性的要求很高，传统渠道主
SDK简介 人证核身服务端SDK是对人证核身提供的REST API进行的封装，您可以直接继承服务端从而实现对人证核身服务的快速操作。 接口与API对应关系 表1 接口与API对应关系 接口 API 人证核身标准版（三要素） POST https://{endpoint}/v2.0/ivs-standard
返回结果 状态码 请求发送以后，您会收到响应，包含状态码、响应消息头和消息体。 状态码是一组数字代码，状态码表示了请求响应的状态，如果调用后返回状态码为2xx，则表示调用成功。完整的状态码列表请参见状态码。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。例如表1所示。
API使用类 查看API使用次数 是否支持生僻字识别，少数民族字体识别 接口的并发是多少 通过js将图片转成base64编码 通过python将图片转成base64编码
如何调用API 申请服务 构造请求 认证鉴权 返回结果
公共数据结构 校验信息说明 IdcardResult
什么是人证核身 人证核身服务（Identity Verification Solution，简称IVS），是指通过用户的身份证信息、人脸图片，与权威数据库进行比对，进而实现身份验证。 当前，人证核身提供以下子功能： 标准版（三要素） 使用姓名、身份证号码、人脸图像三要素进行匹配核验。
错误码类 调用API报错IVS.0015怎么处理 改名字导致的校验不通过怎么处理 APIG.0101报错处理方法 APIG.0201报错处理方法 APIG.0301报错处理方法 APIG.0307报错处理方法 账密报错“The username or password is wrong
证件版（二要素） 使用身份证文本验证 使用身份证图片验证 父主题： API
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
