检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 人证核身服务根据不同场景提供多种API。 表1 接口说明 API 说明 标准版（三要素） 使用姓名、身份证号码、人脸图片三要素进行身份审核。 证件版（二要素） 使用姓名、身份证号码二要素进行身份审核。
如何调用API 申请服务 构造请求 认证鉴权 返回结果
API 标准版（三要素） 证件版（二要素）
调用说明 人证核身提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 父主题： 使用前必读
构造请求 本节介绍REST API请求的组成，并以调用人证核身（三要素）接口为例说明如何调用API，该API获取用户的Token，Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987
响应消息体 响应消息体通常以结构化格式返回，与响应消息头中Content-type对应，传递除响应消息头之外的内容。 对于人证核身标准版（三要素）接口，返回如下消息体。 { "meta": { "uuid": "user_defined" }, "result":
公共数据结构 校验信息说明 IdcardResult
使用方法请参见API签名指南。 如果之前没有生成过AK/SK，可登录“我的凭证”界面，选择“管理访问密钥 > 新增访问密钥”来获取。 签名SDK只提供签名功能，与服务提供的SDK不同，使用时请注意。 AK/SK获取方式请参考获取AK/SK。 父主题： 如何调用API
多项目时，展开“所属区域”，从“项目ID”列获取子项目ID。 调用API获取项目ID 获取项目ID的接口为“GET https://{endpoint}/v3/projects”，其中“{endpoint}”为IAM的终端节点。接口的认证鉴权请参见认证鉴权。 响应示例如下，例如，人证核身服
登录人证核身服务控制台。 选择需要使用的服务，在操作列单击“开通服务”。 图1 开通服务 服务开通成功后，开通状态显示“已开通”。 父主题： 如何调用API
状态码 HTTP 状态码为三位数，分成五个类别：1xx：相关信息；2xx：操作成功；3xx：重定向；4xx：客户端错误；5xx：服务器错误。 状态码如下所示。 状态码 编码 状态说明 100 Continue 继续请求。 这个临时响应用来通知客户端，它的部分请求已经被服务器接收，且仍未被拒绝。
已开通情况下，检查服务的开通区域和调用API时，url中填写的区域是否一致。 500 IVS.0101 Service inner error. 服务内部错误。 请联系华为云支持人员。 当您调用API时，如果遇到“APIGW”,“APIG”开头的错误码，请参见API网关错误码进行处理。 父主题：
Solution，简称IVS）是结合人脸识别、文字识别等技术，对用户身份进行真实性核验。 人证核身服务以开放API的方式提供给用户，您可以根据本文档提供的API来使用服务。 在调用人证核身服务API之前，请确保已经充分了解人证核身服务相关概念，详细信息请参见产品介绍。 父主题： 使用前必读
修订记录 发布日期 修改说明 2021-08-30 第一次正式发布。
证件版（二要素） 使用身份证文本验证 使用身份证图片验证 父主题： API
标准版（三要素） 使用身份证图片、人脸图片验证 使用身份证文本、人脸图片验证 使用身份证图片、人脸视频验证 使用身份证文本、人脸视频验证 父主题： API
使用前必读 概述 调用说明 终端节点 约束与限制 基本概念
附录 状态码 错误码 获取项目ID 获取账号ID
功能介绍 使用姓名、身份证号码二要素进行身份审核。身份验证时，传参数据为姓名、身份证号文本。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST /v2.0/ivs-idcard-extention
使用身份证图片验证 功能介绍 使用姓名、身份证号码二要素进行身份审核。身份验证时，传参数据为身份证正反面图片。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST /v2.0/ivs-idcard-extention
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
