检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
调用API或SDK 在线调试 本地调用
如何调用API 申请服务 构造请求 认证鉴权 返回结果
公共数据结构 校验信息说明 IdcardResult
自动化部署步骤 登录华为云解决方案实施库，选择“一键部署”。 图1 一键部署人证核身解决方案 在选择模板界面中，直接单击“下一步：配置参数”。 图2 选择模板 在配置参数界面中，自定义填写堆栈名称。根据表完成参数配置后，单击“下一步：高级配置”。 图3 配置参数 表1 参数说明 参数名称
权限管理 权限管理 创建IAM用户并授权使用IVS IVS自定义策略
修订记录 发布日期 修改说明 2021-08-30 第一次正式发布。
”变革中，使用华为云人证核身服务可有效对用户身份进行核验，减少冒名顶替、违法操作的风险。 互联网监管 大量互联网应用、手机App需要进行用户实名认证。以社交网络和视频直播为例，近年来随着行业的快速发展，各种不健康内容层出不穷，行业规范的呼声越来越强。使用华为云人证核身服务可对贴吧
SDK简介 人证核身服务端SDK是对人证核身提供的REST API进行的封装，您可以直接继承服务端从而实现对人证核身服务的快速操作。 接口与API对应关系 表1 接口与API对应关系 接口 API 人证核身标准版（三要素） POST https://{endpoint}/v2.0/ivs-standard
已开通情况下，检查服务的开通区域和调用API时，url中填写的区域是否一致。 500 IVS.0101 Service inner error. 服务内部错误。 请联系华为云支持人员。 当您调用API时，如果遇到“APIGW”,“APIG”开头的错误码，请参见API网关错误码进行处理。 父主题： 附录
准备数据 数据要求 受技术与成本多种因素制约，IVS服务存在一些约束限制。 API只支持“华北-北京四”区域。 只支持中国大陆身份证的识别。 只支持JPG格式，图片中人像需无遮挡。 图像数据，base64编码，要求base64编码后大小不超过4MB。 图像各边的像素大小在300到8000px之间。
使用流程简介 人证核身是指通过用户的身份证信息、人脸图片，与权威数据库进行比对，进而实现身份验证。 使用流程 图1 使用流程 使用前必读 用户需要具备编程能力，熟悉Java、Python、iOS、Android、Node.js编程语言。 IVS服务需要用户通过调用API接口，实现
统计API使用量 IVS服务控制台支持查看API的总调用量、调用成功量、调用失败量。 如果您购买了套餐包，可在“套餐包管理”页面，查看已有的套餐包及使用详情。套餐包费用扣减规则请参见“产品介绍 > 计费说明”。
获取账号ID 在调用接口的时候，部分URL中需要填入账号ID（domain-id），所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下： 登录管理控制台。 单击用户名，在下拉列表中单击“我的凭证”。 在“我的凭证”页面的项目列表中查看账号ID。 图1 查看账号ID 父主题：
什么是人证核身 人证核身服务（Identity Verification Solution，简称IVS），是指通过用户的身份证信息、人脸图片，与权威数据库进行比对，进而实现身份验证。 当前，人证核身提供以下子功能： 标准版（三要素） 使用姓名、身份证号码、人脸图像三要素进行匹配核验。
概述 人证核身服务（Identity Verification Solution，简称IVS）是结合人脸识别、文字识别等技术，对用户身份进行真实性核验。 人证核身服务以开放API的方式提供给用户，您可以根据本文档提供的API来使用服务。 在调用人证核身服务API之前，请确保已经充
调用说明 人证核身提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 父主题： 使用前必读
本样例以“华北-北京四”区域为例，获取对应的项目ID（project_id）。 图2 我的凭证 安装SDK 使用SDK前需要安装华为云Go SDK 库。 # 安装华为云Go库 go get -u github.com/huaweicloud/huaweicloud-sdk-go-v3 # 安装依赖
以JSON格式返回给用户。人证核身成功时，会返回校验通过信息；人证核身失败时，会返回校验失败的具体原因。 前提条件 注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费、冻结、被注销等异常状态。 已开通人证核身服务。 操作步骤 获取并安装IVS Python SDK。 以PyCharm为例，介绍如何安装SDK。
校验信息说明 表1 验证信息 检验代码 检验结果 检验信息 说明 1000 valid Successful certification 认证成功。 2001 invalid Inconsistent identity information 认证信息不一致，即姓名与身份证号码不一致。
需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 关于Token有效期的详细说明请参见获取IAM用户Token（使用密码）。 如果您的华为云账号已升级为华为账号，将不支持获取账号Token。建议为您自己创建一个IAM用户，获取IAM用户的Token。详细说明请参见账密报错。 To
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
