检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
返回结果 状态码 请求发送以后,您会收到响应,包含状态码、响应消息头和消息体。 状态码是一组数字代码,状态码表示了请求响应的状态,如果调用后返回状态码为2xx,则表示调用成功。完整的状态码列表请参见状态码。 响应消息头 对应请求消息头,响应同样也有消息头,如“Content-type”。例如表1所示。
获取账号ID 在调用接口的时候,部分URL中需要填入账号ID(domain-id),所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下: 登录管理控制台。 单击用户名,在下拉列表中单击“我的凭证”。 在“我的凭证”页面的项目列表中查看账号ID。 图1 查看账号ID 父主题:
本地调用 本章节以证件版(二要素)API为例,介绍如何使用IVS Python SDK在本地进行开发。 该接口使用姓名、身份证号码二要素进行身份审核,并将识别结果以JSON格式返回给用户。人证核身成功时,会返回校验通过信息;人证核身失败时,会返回校验失败的具体原因。 前提条件 注
开始使用 动作活体检测视频采集要求 表1 动作活体检测视频检测要求 活体检测动作 动作示例 视频动作说明 左摇头 √,左摇头幅度正常。 ×,左摇头幅度过大,超出画面。 右摇头 √,右摇头幅度正常。 ×,右摇头幅度过大,超出画面。 点头 √,点头幅度正常 ×,点头幅度过大,超出画面。
调用SDK实现人证核身证件版(二要素) 人证核身服务软件开发工具包(IVS SDK)是对人证核身服务提供的REST API进行的封装,以简化用户的开发工作。 人证核身证件版(二要素)API为例,介绍如何使用IVS Python SDK。 使用IVS SDK的详细步骤如下所示: 步骤1:开通服务
获取项目ID 从控制台获取项目ID 登录管理控制台。 鼠标移动到右上角的用户名上,在下拉列表中选择“我的凭证”。 在“我的凭证”页面,可以查看用户名、账号名,在项目列表中查看项目。 图1 查看项目ID 多项目时,展开“所属区域”,从“项目ID”列获取子项目ID。 调用API获取项目ID
计费说明 计费项 按API调用次数按需计费。 只有调用成功才会计算调用次数,其中200状态码表示调用成功。 费用账单 费用账单可以在费用中心进行查看、导出。 图1 明细账单 账单数据是唯一标准的计费数据,只对用户调用中状态码满足范围内的调用,进行收费。只有调用成功才会计算调用次数
获取OBS中对象URL OBS服务简介 对象存储服务(Object Storage Service,OBS)是一个基于对象的海量存储服务,为客户提供海量、安全、高可靠、低成本的数据存储能力。 创建OBS桶 登录对象存储服务控制台。 左侧导航栏选择“桶列表”,在右上角选择“创建桶”。按下图配置完成OBS桶的创建。
终端节点 终端节点即调用API的请求地址,不同服务不同区域的终端节点不同,您可以从地区和终端节点中查询所有服务的终端节点。 人证核身的终端节点如表1所示,请您根据业务需要选择对应区域的终端节点。 表1 人证核身的终端节点 区域名称 区域 终端节点(Endpoint) 部署服务 华北-北京四
Python SDK 本章节介绍人证核身服务Python SDK,您可以参考本章节进行快速集成开发。 准备工作 注册华为账号并开通华为云,并完成实名认证,账号不能处于欠费或冻结状态。 已开通人证核身服务。如未开通,请登录人证核身管理控制台开通所需服务。 已具备开发环境,支持Python3及以上版本。
IdcardResult 身份证图像文字识别结果结构体。 表1 结构体说明 参数 类型 描述 name String 身份证上识别的名称。 number String 身份证号。 sex String 性别。 birth String 出生日期。 ethnicity String
自动化部署步骤 登录华为云解决方案实施库,选择“一键部署”。 图1 一键部署人证核身解决方案 在选择模板界面中,直接单击“下一步:配置参数”。 图2 选择模板 在配置参数界面中,自定义填写堆栈名称。根据表完成参数配置后,单击“下一步:高级配置”。 图3 配置参数 表1 参数说明 参数名称
状态码 HTTP 状态码为三位数,分成五个类别:1xx:相关信息;2xx:操作成功;3xx:重定向;4xx:客户端错误;5xx:服务器错误。 状态码如下所示。 状态码 编码 状态说明 100 Continue 继续请求。 这个临时响应用来通知客户端,它的部分请求已经被服务器接收,且仍未被拒绝。
权限管理 如果您需要对华为云上购买的IVS资源,为企业中的员工设置不同的访问权限,以达到不同员工之间的权限隔离,您可以使用统一身份认证服务(Identity and Access Management,简称IAM)进行精细的权限管理。该服务提供用户身份认证、权限分配、访问控制等功
开通人证核身服务 IVS服务提供的开通方式有以下两种,用户可以任选其一进行开通服务。 按需计费开通服务 登录IVS服务控制台。 选择需要使用的服务,在操作列单击“开通服务”,此时的计费方式采用按需计费。 图1 开通服务 服务开通成功后,开通状态将显示为“已开通”。 IVS服务开通
API概览 人证核身服务根据不同场景提供多种API。 表1 接口说明 API 说明 标准版(三要素) 使用姓名、身份证号码、人脸图片三要素进行身份审核。 证件版(二要素) 使用姓名、身份证号码二要素进行身份审核。
创建IAM用户并授权使用IVS 如果您需要对您所拥有的IVS进行精细的权限管理,您可以使用统一身份认证服务(Identity and Access Management,简称IAM),通过IAM,您可以: 根据企业的业务组织,在您的华为云账号中,给企业中不同职能部门的员工创建IA
入门实践 当您完成了调用API、调用SDK基本操作后,可以根据自身的业务需求使用IVS提供的入门实践。 表1 常用最佳实践 实践 描述 活体人证核身 该实践基于于华为云人证核身服务IVS和人脸识别服务FRS构建,通过动作活体检测判断操作用户是否为真人,并将检测结果与用户身份证信息
认证鉴权 调用接口有如下两种认证方式,您可以选择其中一种进行认证鉴权。 Token认证:通过Token认证调用请求。 AK/SK认证:通过AK(Access Key ID)/SK(Secret Access Key)加密调用请求。 Token认证 需要使用一个Token鉴权时,可以先缓存起来,避免频繁调用。
通过js将图片转成base64编码 下方示例代码通过js将图片转换成base64编码。功能如下: 在页面加载完成后,给id为imgUpload的文件输入框添加了一个onchange事件监听器,当用户选择了一张图片后,就调用getBase64函数。 getBase64函数接收一个文