检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API使用类 查看API使用次数 是否支持生僻字识别,少数民族字体识别 接口的并发是多少 通过js将图片转成base64编码 通过python将图片转成base64编码
如何调用API 申请服务 构造请求 认证鉴权 返回结果
查看API使用次数 登录人证核身服务控制台。 在“云上服务管理”页面,查看API的使用量和套餐包的使用量。 图1 API使用量统计 父主题: API使用类
统计API使用量 IVS服务控制台支持查看API的总调用量、调用成功量、调用失败量。 如果您购买了套餐包,可在“套餐包管理”页面,查看已有的套餐包及使用详情。套餐包费用扣减规则请参见“产品介绍 > 计费说明”。
附录 状态码 错误码 获取项目ID 获取账号ID
调用API或SDK 在线调试 本地调用
证件版(二要素) 使用身份证文本验证 使用身份证图片验证 父主题: API
请求方法 HTTP请求方法(也称为操作或动词),它告诉服务你正在请求什么类型的操作。 表2 HTTP方法 方法 说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。
修订记录 发布日期 修改说明 2021-08-30 第一次正式发布。
返回结果 状态码 请求发送以后,您会收到响应,包含状态码、响应消息头和消息体。 状态码是一组数字代码,状态码表示了请求响应的状态,如果调用后返回状态码为2xx,则表示调用成功。完整的状态码列表请参见状态码。 响应消息头 对应请求消息头,响应同样也有消息头,如“Content-type
在调用人证核身服务API之前,请确保已经充分了解人证核身服务相关概念,详细信息请参见产品介绍。 父主题: 使用前必读
使用前必读 概述 调用说明 终端节点 约束与限制 基本概念
500 Internal Server Error 表明服务端能被请求访问到,但是不能理解用户的请求。 501 Not Implemented 服务器不支持请求的功能,无法完成请求。 502 Bad Gateway 充当网关或代理的服务器,从远端服务器接收到了一个无效的请求。
获取Token的终端节点和project name需与IVS服务终端节点保持一致。
公共数据结构 校验信息说明 IdcardResult
响应示例如下,例如,人证核身服务部署的区域为“cn-north-4”,响应消息体中查找“name”为“cn-north-4”,其中“projects”下的“id”即为项目ID。
Region分为通用Region和专属Region,通用Region指面向公共租户提供通用云服务的Region;专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。 详情请参见区域和可用区。
获取账号ID 在调用接口的时候,部分URL中需要填入账号ID(domain-id),所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下: 登录管理控制台。 单击用户名,在下拉列表中单击“我的凭证”。 在“我的凭证”页面的项目列表中查看账号ID。 图1 查看账号ID 父主题
已开通人证核身服务。 操作步骤 登录API Explorer。 登录后,“X-Auth-Token”和“project_id”参数会自动填充,无需填写。 填写待验证的身份证信息。
约束与限制 只支持“华北-北京四”区域。 只支持中国大陆身份证的识别。 只支持JPG格式,图片中人像需无遮挡。 图像数据,base64编码,要求base64编码后大小不超过4MB。 图像各边的像素大小在300到8000px之间。 图像中身份证区域有效占比超过15%,保证整张身份证内容及其边缘包含在图像内