检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 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
证件版（二要素） 使用身份证文本验证 使用身份证图片验证 父主题： API
认证鉴权 调用接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。 Token认证：通过Token认证调用请求。 AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key)加密调用请求。 Token认证 需要使用一个Token鉴权时，可以先缓存起来
标准版（三要素） 使用身份证图片、人脸图片验证 使用身份证文本、人脸图片验证 使用身份证图片、人脸视频验证 使用身份证文本、人脸视频验证 父主题： API
使用身份证文本验证 功能介绍 使用姓名、身份证号码二要素进行身份审核。身份验证时，传参数据为姓名、身份证号文本。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST
使用身份证图片验证 功能介绍 使用姓名、身份证号码二要素进行身份审核。身份验证时，传参数据为身份证正反面图片。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST
使用身份证文本、人脸视频验证 功能介绍 使用姓名、身份证号文本，并对视频做活体检测后提取人脸图片，以此进行三要素身份审核。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI
使用身份证图片、人脸视频验证 功能介绍 从身份证正反面图片中提取姓名和身份证号码，并对视频做活体检测后提取人脸图片，以此进行三要素身份审核。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能
使用身份证文本、人脸图片验证 功能介绍 使用姓名、身份证号文本和人脸图片进行三要素身份审核。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST /v2.0/ivs-standard
附录 状态码 错误码 获取项目ID 获取账号ID
使用身份证图片、人脸图片验证 功能介绍 使用身份证正反面图片提取姓名和身份证号码，与人脸图片进行三要素身份审核。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST
修订记录 发布日期 修改说明 2021-08-30 第一次正式发布。
使用前必读 概述 调用说明 终端节点 约束与限制 基本概念
概述 人证核身服务（Identity Verification Solution，简称IVS）是结合人脸识别、文字识别等技术，对用户身份进行真实性核验。 人证核身服务以开放API的方式提供给用户，您可以根据本文档提供的API来使用服务。 在调用人证核身服务API之前，请确保已经充分了解人证核身服务相关概念
公共数据结构 校验信息说明 IdcardResult
状态码 HTTP 状态码为三位数，分成五个类别：1xx：相关信息；2xx：操作成功；3xx：重定向；4xx：客户端错误；5xx：服务器错误。 状态码如下所示。 状态码 编码 状态说明 100 Continue 继续请求。 这个临时响应用来通知客户端，它的部分请求已经被服务器接收，且仍未被拒绝
调用说明 人证核身提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 父主题： 使用前必读
获取项目ID 从控制台获取项目ID 登录管理控制台。 鼠标移动到右上角的用户名上，在下拉列表中选择“我的凭证”。 在“我的凭证”页面，可以查看用户名、账号名，在项目列表中查看项目。 图1 查看项目ID 多项目时，展开“所属区域”，从“项目ID”列获取子项目ID。 调用API获取项目
约束与限制 只支持“华北-北京四”区域。 只支持中国大陆身份证的识别。 只支持JPG格式，图片中人像需无遮挡。 图像数据，base64编码，要求base64编码后大小不超过4MB。 图像各边的像素大小在300到8000px之间。 图像中身份证区域有效占比超过15%，保证整张身份证内容及其边缘包含在图像内
基本概念 账号 用户注册华为云时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用他们进行日常管理工作。 用户 由账号在IAM中创建的用户，是云服务的使用人员
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
