检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API 标准版（三要素） 证件版（二要素）
修订记录 发布日期 修改说明 2021-08-30 第一次正式发布。
API使用类 查看API使用次数 是否支持生僻字识别，少数民族字体识别 接口的并发是多少 通过js将图片转成base64编码 通过python将图片转成base64编码
什么是人证核身 人证核身服务（Identity Verification Solution，简称IVS），是指通过用户的身份证信息、人脸图片，与权威数据库进行比对，进而实现身份验证。 当前，人证核身提供以下子功能： 标准版（三要素） 使用姓名、身份证号码、人脸图像三要素进行匹配核验。
产品咨询类 如何开通服务，计费规则 是否能退订服务，退订套餐包
、O2O服务监管、网络/手机游戏防沉迷监管、访客登记、密码保护等领域。 金融、保险行业 银行、互联网金融、证券、保险公司等金融机构对用户身份真实性的要求很高，传统渠道主要依赖用户上门进行人工核验身份，继而完成开户、交易等行为，不仅费时费力且用户体验较差。华为云人证核身服务可有效实
SDK简介 人证核身服务端SDK是对人证核身提供的REST API进行的封装，您可以直接继承服务端从而实现对人证核身服务的快速操作。 接口与API对应关系 表1 接口与API对应关系 接口 API 人证核身标准版（三要素） POST https://{endpoint}/v2.0/ivs-standard
使用前必读 概述 调用说明 终端节点 约束与限制 基本概念
概述 人证核身服务（Identity Verification Solution，简称IVS）是结合人脸识别、文字识别等技术，对用户身份进行真实性核验。 人证核身服务以开放API的方式提供给用户，您可以根据本文档提供的API来使用服务。 在调用人证核身服务API之前，请确保已经充
API会返回JSON格式的识别结果，用户需要通过编码将识别结果对接到业务系统中。 关于人证核身服务的相关声明请参见人证核身服务免责声明。 人证核身服务等级协议请参见华为云服务等级协议。
如何调用API 申请服务 构造请求 认证鉴权 返回结果
公共数据结构 校验信息说明 IdcardResult
错误码类 调用API报错IVS.0015怎么处理 改名字导致的校验不通过怎么处理 APIG.0101报错处理方法 APIG.0201报错处理方法 APIG.0301报错处理方法 APIG.0307报错处理方法 账密报错“The username or password is wrong
service has been frozen. 服务已冻结。 请检查是否有欠费。 400 IVS.0015 The subservice has not been subscribed. 服务未开通。 请登录控制台开通人证核身服务。 已开通情况下，检查服务的开通区域和调用API时，url中填写的区域是否一致。
区域与可用区 什么是区域与可用区
活体人证核验解决方案 方案概述 资源与成本规划 实施步骤 附录
调用说明 人证核身提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 父主题： 使用前必读
统计API使用量 IVS服务控制台支持查看API的总调用量、调用成功量、调用失败量。 如果您购买了套餐包，可在“套餐包管理”页面，查看已有的套餐包及使用详情。套餐包费用扣减规则请参见“产品介绍 > 计费说明”。
HTTP请求方法（也称为操作或动词），它告诉服务你正在请求什么类型的操作。 表2 HTTP方法 方法 说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。 DELETE 请求服务器删除指定资源，如删除对象等。 HEAD 请求服务器资源头部。 PATCH
证件版（二要素） 使用身份证文本验证 使用身份证图片验证 父主题： API
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
