检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 人证核身服务根据不同场景提供多种API。 表1 接口说明 API 说明 标准版（三要素） 使用姓名、身份证号码、人脸图片三要素进行身份审核。 证件版（二要素） 使用姓名、身份证号码二要素进行身份审核。
API 标准版（三要素） 证件版（二要素）
调用API或SDK 在线调试 本地调用
如何调用API 申请服务 构造请求 认证鉴权 返回结果
API使用类 查看API使用次数 是否支持生僻字识别，少数民族字体识别 接口的并发是多少 通过js将图片转成base64编码 通过python将图片转成base64编码
查看API使用次数 登录人证核身服务控制台。 在“云上服务管理”页面，查看API的使用量和套餐包的使用量。 图1 API使用量统计 父主题： API使用类
统计API使用量 IVS服务控制台支持查看API的总调用量、调用成功量、调用失败量。 如果您购买了套餐包，可在“套餐包管理”页面，查看已有的套餐包及使用详情。套餐包费用扣减规则请参见“产品介绍 > 计费说明”。
构造请求 本节介绍REST API请求的组成，并以调用人证核身（三要素）接口为例说明如何调用API，该API获取用户的Token，Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987
调用API报错IVS.0015怎么处理 问题现象 调用人证核身接口时，报错“IVS.0015”。 该报错表示调用的API没有开通。 解决方法 请先登录控制台开通所需的服务。 如已开通，检查开通服务区域和实际调用的API的区域是否一致。 图1 检查区域信息 父主题： 错误码类
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：获取API凭证 步骤4：Token认证鉴权 步骤5：调用服务
Content-Type 响应消息体的MIME类型。 响应消息体 响应消息体通常以结构化格式返回，与响应消息头中Content-type对应，传递除响应消息头之外的内容。 对于人证核身标准版（三要素）接口，返回如下消息体。 { "meta": { "uuid":
Token有效期为24小时，请使用重新获取Token调用API。 检查接口URL中的终端节点是否填写正确。部署在不同区域间的服务，不可以跨区域调用。如果调用了不同区域的接口，导致判断为Token失效，显示APIG.0307错误码。 父主题： 错误码类
APIG.0201报错处理方法 如果调用API时返回错误信息与错误码："error_msg":"Backend timeout.","error_code":"APIG.0201"，表示请求超时。 您可以尝试以下方案进行解决。 使用Postman等工具直接调用服务，查看是否成功，
verification_id is invalid. 请求参数格式错误，参数长度超出范围。 请求参数格式错误，解析参数出现错误。 请求参数格式错误，参数的值为null或空。 请求参数格式错误，verification_name 包含了无效字符。 请求参数格式错误，verification_id长度需为15位或18位。
APIG.0101报错处理方法 访问的API不存在或尚未在环境中发布：The API does not exist or has not been published in the environment. 请检查API的URL是否拼写正确。 检查URI中的区域信息是否和调用服务配置的终端节点是否对应。
证件版（二要素） 使用身份证文本验证 使用身份证图片验证 父主题： API
用户需要具备编程能力，熟悉Java、Python、iOS、Android、Node.js编程语言。 IVS服务需要用户通过调用API接口，实现身份信息核验。API会返回JSON格式的识别结果，用户需要通过编码将识别结果对接到业务系统中。 关于人证核身服务的相关声明请参见人证核身服务免责声明。
使用身份证图片验证 功能介绍 使用姓名、身份证号码二要素进行身份审核。身份验证时，传参数据为身份证正反面图片。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST /v2.0/ivs-idcard-extention
从身份证正反面图片中提取姓名和身份证号码，并对视频做活体检测后提取人脸图片，以此进行三要素身份审核。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST /v2.0/ivs-standard
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
