检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
构造请求 本节介绍REST API请求的组成，并以调用人证核身（三要素）接口为例说明如何调用API，该API获取用户的Token，Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987
自动化部署步骤 登录华为云解决方案实施库，选择“一键部署”。 图1 一键部署人证核身解决方案 在选择模板界面中，直接单击“下一步：配置参数”。 图2 选择模板 在配置参数界面中，自定义填写堆栈名称。根据表完成参数配置后，单击“下一步：高级配置”。 图3 配置参数 表1 参数说明 参数名称
调用API或SDK 在线调试 本地调用
如何调用API 申请服务 构造请求 认证鉴权 返回结果
公共数据结构 校验信息说明 IdcardResult
使用流程简介 人证核身是指通过用户的身份证信息、人脸图片，与权威数据库进行比对，进而实现身份验证。 使用流程 图1 使用流程 使用前必读 用户需要具备编程能力，熟悉Java、Python、iOS、Android、Node.js编程语言。 IVS服务需要用户通过调用API接口，实现
Python SDK 本章节介绍人证核身服务Python SDK，您可以参考本章节进行快速集成开发。 准备工作 注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。 已开通人证核身服务。如未开通，请登录人证核身管理控制台开通所需服务。 已具备开发环境，支持Python3及以上版本。
$projectId); 认证参数说明： ak、sk：访问秘钥信息，获取方法请参见准备工作。 projectId：华为云项目ID，获取方法请参见准备工作。 endpoint：华为云各服务应用区域和各服务的终端节点，详情请查看 地区和终端节点 。 认证用的 ak 和sk 硬编码到代码中或者明
状态码 HTTP 状态码为三位数，分成五个类别：1xx：相关信息；2xx：操作成功；3xx：重定向；4xx：客户端错误；5xx：服务器错误。 状态码如下所示。 状态码 编码 状态说明 100 Continue 继续请求。 这个临时响应用来通知客户端，它的部分请求已经被服务器接收，且仍未被拒绝。
本样例以“华北-北京四”区域为例，获取对应的项目ID（project_id）。 图2 我的凭证 安装SDK 使用SDK前需要安装华为云Go SDK 库。 # 安装华为云Go库 go get -u github.com/huaweicloud/huaweicloud-sdk-go-v3 # 安装依赖
NET SDK 本章节介绍.NET SDK，您可以参考本章节进行快速集成开发。 准备工作 注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。 已具备开发环境，.NET SDK 适用于.NET Standard 2.0 及其以上版本；C# 4.0 及其以上版本。
概述 人证核身服务（Identity Verification Solution，简称IVS）是结合人脸识别、文字识别等技术，对用户身份进行真实性核验。 人证核身服务以开放API的方式提供给用户，您可以根据本文档提供的API来使用服务。 在调用人证核身服务API之前，请确保已经充
获取账号ID 在调用接口的时候，部分URL中需要填入账号ID（domain-id），所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下： 登录管理控制台。 单击用户名，在下拉列表中单击“我的凭证”。 在“我的凭证”页面的项目列表中查看账号ID。 图1 查看账号ID 父主题：
C++ SDK 本章节介绍新版C++ SDK，您可以参考本章节进行快速集成开发。 准备工作 注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。 已具备开发环境，支持 C++ 14 及以上版本，要求安装 CMake 3.10 及以上版本。 登录“我的凭证 > 访问秘钥”页面，获取Access
调用说明 人证核身提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 父主题： 使用前必读
以JSON格式返回给用户。人证核身成功时，会返回校验通过信息；人证核身失败时，会返回校验失败的具体原因。 前提条件 注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费、冻结、被注销等异常状态。 已开通人证核身服务。 操作步骤 获取并安装IVS Python SDK。 以PyCharm为例，介绍如何安装SDK。
校验信息说明 表1 验证信息 检验代码 检验结果 检验信息 说明 1000 valid Successful certification 认证成功。 2001 invalid Inconsistent identity information 认证信息不一致，即姓名与身份证号码不一致。
返回结果 状态码 请求发送以后，您会收到响应，包含状态码、响应消息头和消息体。 状态码是一组数字代码，状态码表示了请求响应的状态，如果调用后返回状态码为2xx，则表示调用成功。完整的状态码列表请参见状态码。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。例如表1所示。
需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 关于Token有效期的详细说明请参见获取IAM用户Token（使用密码）。 如果您的华为云账号已升级为华为账号，将不支持获取账号Token。建议为您自己创建一个IAM用户，获取IAM用户的Token。详细说明请参见账密报错。 To
接口的并发是多少 人证核身标准版（三要素）、人证核身证件版（二要素）默认并发为10qps。 父主题： API使用类
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
