检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
IVS服务需要用户通过调用API接口,实现身份信息核验。API会返回JSON格式的识别结果,用户需要通过编码将识别结果对接到业务系统中。 关于人证核身服务的相关声明请参见人证核身服务免责声明。 人证核身服务等级协议请参见华为云服务等级协议。
101 Switching Protocols 切换协议。只能切换到更高级的协议。 例如,切换到HTTPS的新版本协议。 200 OK 服务器已成功处理了请求。 201 Created 创建类的请求完全成功。 202 Accepted 已经接受请求,但未处理完成。
调用API报错IVS.0015怎么处理 问题现象 调用人证核身接口时,报错“IVS.0015”。 该报错表示调用的API没有开通。 解决方法 请先登录控制台开通所需的服务。 如已开通,检查开通服务区域和实际调用的API的区域是否一致。 图1 检查区域信息 父主题: 错误码类
表1 URI中的参数说明 参数 说明 URI-scheme 表示用于传输请求的协议,当前所有API均采用HTTPS协议。 endpoint 指定承载REST服务端点的服务器域名或IP,不同服务不同区域的endpoint不同,您可以从地区和终端节点获取。
API 标准版(三要素) 证件版(二要素)
API概览 人证核身服务根据不同场景提供多种API。 表1 接口说明 API 说明 标准版(三要素) 使用姓名、身份证号码、人脸图片三要素进行身份审核。 证件版(二要素) 使用姓名、身份证号码二要素进行身份审核。
接口的并发是多少 人证核身标准版(三要素)、人证核身证件版(二要素)默认并发为10qps。 父主题: API使用类
API使用类 查看API使用次数 是否支持生僻字识别,少数民族字体识别 接口的并发是多少 通过js将图片转成base64编码 通过python将图片转成base64编码
如何调用API 申请服务 构造请求 认证鉴权 返回结果
查看API使用次数 登录人证核身服务控制台。 在“云上服务管理”页面,查看API的使用量和套餐包的使用量。 图1 API使用量统计 父主题: API使用类
统计API使用量 IVS服务控制台支持查看API的总调用量、调用成功量、调用失败量。 如果您购买了套餐包,可在“套餐包管理”页面,查看已有的套餐包及使用详情。套餐包费用扣减规则请参见“产品介绍 > 计费说明”。
调用API或SDK 在线调试 本地调用
APIG.0101报错处理方法 访问的API不存在或尚未在环境中发布:The API does not exist or has not been published in the environment. 请检查API的URL是否拼写正确。 检查URI中的区域信息是否和调用服务配置的终端节点是否对应
APIG.0201报错处理方法 如果调用API时返回错误信息与错误码:"error_msg":"Backend timeout.","error_code":"APIG.0201",表示请求超时。 您可以尝试以下方案进行解决。 使用Postman等工具直接调用服务,查看是否成功,如果调用成功表示服务接口没有问题
APIG.0307报错处理方法 如果调用API时返回错误信息与错误码:"error_msg":"The token must be updated.","error_code":"APIG.0307",是因为Token失效,需要进行更新。 您可以尝试以下方案进行解决。 Token有效期为
APIG.0301报错处理方法 如果在调用API时返回错误信息与错误码: "error_msg":"Incorrect IAM authentication information: decrypt token fail","error_code":"APIG.0301",是因为token
调用API实现人证核身证件版(二要素) 本章节通过Postman调用人证核身证件版(二要素)API为例,帮助您快速体验并熟悉IVS服务的使用方法。 使用IVS服务API的详细步骤如下所示: 步骤1:开通服务 步骤2:配置环境 步骤3:Token认证鉴权 步骤4:调用服务 准备工作
申请服务 正式使用服务之前,必须先申请开通服务,下面是相关服务申请的步骤。 首次使用服务时,需要先申请开通该服务。服务只需要开通一次即可,后面使用时无需再次申请。如未开通服务,调用服务时会提示IVS.0015报错,请在调用服务前先进入控制台开通服务,并注意开通服务区域与调用服务的区域保持一致
返回结果 状态码 请求发送以后,您会收到响应,包含状态码、响应消息头和消息体。 状态码是一组数字代码,状态码表示了请求响应的状态,如果调用后返回状态码为2xx,则表示调用成功。完整的状态码列表请参见状态码。 响应消息头 对应请求消息头,响应同样也有消息头,如“Content-type
证件版(二要素) 使用身份证文本验证 使用身份证图片验证 父主题: API