检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
状态码 编码 状态说明 100 Continue 继续请求。 这个临时响应用来通知客户端，它的部分请求已经被服务器接收，且仍未被拒绝。 101 Switching Protocols 切换协议。只能切换到更高级的协议。 例如，切换到HTTPS的新版本协议。
video 是 String 现场拍摄人像视频数据，使用base64编码。 视频文件大小不超过8MB，建议客户端压缩到200KB~2MB。要求base64编码后大小不超过10M。 限制视频时长1～15秒。 建议帧率10fps～30fps。
视频要求：视频Base64编码后大小不超过8MB。 限制视频时长1~15秒。 建议帧率：10fps~30fps。 封装格式：mp4、avi、flv、webm、asf、mov。 视频编码格式: h261、h263、h264、hevc、vc1、vp8、vp9、wmv3。
要求base 64编码后大小不超过10MB。建议客户端压缩至200KB至2MB。 400 IVS.0006 The input face image is invalid. 输入的人脸图像不合法。 要求base64编码后大小不超过4MB。
face_image 是 String 现场人像图像数据，使用base64编码，要求base64编码后大小不超过4M。图像各边的像素大小在300到4000之间，支持JPG格式。 detail 否 Boolean 响应参数similarity是否详细显示,默认为false。
自动化部署步骤 登录华为云解决方案实施库，选择“一键部署”。 图1 一键部署人证核身解决方案 在选择模板界面中，直接单击“下一步：配置参数”。 图2 选择模板 在配置参数界面中，自定义填写堆栈名称。根据表完成参数配置后，单击“下一步：高级配置”。 图3 配置参数 表1 参数说明 参数名称
IdcardResult 身份证图像文字识别结果结构体。 表1 结构体说明 参数 类型 描述 name String 身份证上识别的名称。 number String 身份证号。 sex String 性别。 birth String 出生日期。 ethnicity String
若请求消息体中参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。
概述 人证核身服务（Identity Verification Solution，简称IVS）是结合人脸识别、文字识别等技术，对用户身份进行真实性核验。 人证核身服务以开放API的方式提供给用户，您可以根据本文档提供的API来使用服务。 在调用人证核身服务API之前，请确保已经充分了解人证核身服务相关概念
本地调用 本章节以证件版（二要素）API为例，介绍如何使用IVS Python SDK在本地进行开发。 该接口使用姓名、身份证号码二要素进行身份审核，并将识别结果以JSON格式返回给用户。人证核身成功时，会返回校验通过信息；人证核身失败时，会返回校验失败的具体原因。 前提条件 注册华为账号并开通华为云
方案概述 应用场景 该解决方案基于华为云人证核身服务IVS和人脸识别服务FRS构建，通过动作活体检测判断操作用户是否为真人，并将检测结果与用户身份证信息关联起来，使用人证核身技术，实现对用户身份真实性的核验。 适用于金融保险、物流快递、游戏、互联网、差旅住宿等多种行业的账号实名注册
使用身份证文本验证 功能介绍 使用姓名、身份证号码二要素进行身份审核。身份验证时，传参数据为姓名、身份证号文本。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST
在线调试 API Explorer在线调试工具提供API的检索、调试、代码示例生成功能。同时，集成开发环境CloudIDE，可完成代码的构建、调试、运行。 本章节以证件版（二要素）API为例，介绍如何使用API Explorer调试API。 前提条件 注册华为账号并开通华为云，并完成实名认证
什么是人证核身 人证核身服务（Identity Verification Solution，简称IVS），是指通过用户的身份证信息、人脸图片，与权威数据库进行比对，进而实现身份验证。 当前，人证核身提供以下子功能： 标准版（三要素） 使用姓名、身份证号码、人脸图像三要素进行匹配核验
准备工作 开通人证核身服务 登录人证核身控制台。 在控制台左上角选择区域为“北京四”，并开通“人证核身标准版（三要素）”。 开通后，默认为按需计费。 图1 开通“人证核身标准版（三要素）” 开通人脸识别服务 登录人脸识别控制台。 在控制台左上角选择区域为“北京四”，并开通“动作活体检测
入门实践 当您完成了调用API、调用SDK基本操作后，可以根据自身的业务需求使用IVS提供的入门实践。 表1 常用最佳实践 实践 描述 活体人证核身 该实践基于于华为云人证核身服务IVS和人脸识别服务FRS构建，通过动作活体检测判断操作用户是否为真人，并将检测结果与用户身份证信息关联起来
资源与成本规划 该解决方案主要部署如下资源，需要的产品列表和配置示例如表1、表2所示，以下花费仅供参考。 表1 产品配置说明 产品 配置示例 人脸识别服务 区域：华北-北京四 计费模式：按需计费 涉及服务：动作活体检测 人证核身服务 区域：华北-北京四 计费模式：按需计费 涉及服务
调用SDK实现人证核身证件版（二要素） 人证核身服务软件开发工具包（IVS SDK）是对人证核身服务提供的REST API进行的封装，以简化用户的开发工作。 人证核身证件版（二要素）API为例，介绍如何使用IVS Python SDK。 使用IVS SDK的详细步骤如下所示： 步骤
IVS自定义策略 如果系统预置的权限，不满足您的授权要求，可以创建自定义策略。自定义策略中可以添加的授权项（Action）请参见权限管理。 目前华为云支持以下两种方式创建自定义策略： 可视化视图创建自定义策略：无需了解策略语法，按可视化视图导航栏选择云服务、操作、资源、条件等策略内容
调用API实现人证核身证件版（二要素） 本章节通过Postman调用人证核身证件版（二要素）API为例，帮助您快速体验并熟悉IVS服务的使用方法。 使用IVS服务API的详细步骤如下所示： 步骤1：开通服务 步骤2：配置环境 步骤3：获取API凭证 步骤4：Token认证鉴权 步骤
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
