人证核身服务 IVS-使用身份证文本、人脸视频验证:请求参数

时间:2024-11-25 17:13:11

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

X-Auth-Token值获取方法请参见认证鉴权

Enterprise-Project-Id

String

企业项目ID。IVS支持通过企业项目管理(EPS)对不同用户组和用户的资源使用,进行分账。

获取方法:进入“企业项目管理”页面,单击企业项目名称,在企业项目详情页获取Enterprise-Project-Id(企业项目ID)。

企业项目创建步骤请参见用户指南。

说明:

说明: 创建企业项目后,在传参时,有以下三类场景。

  • 携带正确的ID,正常使用IVS服务,账单的企业项目会被分类到企业ID对应的企业项目中。
  • 携带格式正确但不存在的ID,正常使用IVS服务,账单的企业项目会显示对应不存在的企业项目ID。
  • 不携带ID或格式错误ID(包含特殊字符等),正常使用IVS服务,账单的企业项目会被分类到"default"中。
表2 请求Body参数

参数

是否必选

参数类型

描述

meta

Meta object

请求元数据,例如表征本次请求的唯一标注uuid。

data

data object

请求消息的数据部分。

表3 Meta

参数

是否必选

参数类型

描述

uuid

String

唯一标识此次请求的ID,用户自定义,不超过64位。

表4 data

参数

是否必选

参数类型

描述

req_data

Array of StandardReqDataByVideoAndNameAndId objects

请求列表,用于支持批量调用。目前暂时只支持单个数据查询。

表5 StandardReqDataByVideoAndNameAndId

参数

是否必选

参数类型

描述

verification_name

String

被验证人的姓名。

verification_id

String

被验证人的身份证号码。

video

String

现场拍摄人像视频数据,使用base64编码。

  • 视频文件大小不超过8MB,建议客户端压缩到200KB~2MB。要求base64编码后大小不超过10M。
  • 限制视频时长1~15秒。
  • 建议帧率10fps~30fps。
  • 封装格式:mp4、avi、flv、webm、asf、mov。
  • 视频编码格式:h261、h263、h264、hevc、vc1、vp8、vp9、wmv3。

actions

String

动作代码顺序列表,英文逗号(,)分隔。建议单动作,目前支持的动作有: 1:左摇头 2:右摇头 3:点头 4:嘴部动作

嘴部动作建议嘴唇距离大于3厘米,左右摇头动作建议角度15-30度。

nod_threshold

Double

该参数为点头动作幅度的判断门限,取值范围:[1,90],默认为10,单位为度。该值设置越大,则越难判断为点头。

detail

Boolean

响应参数similarity是否详细显示,默认为false。

  • true表示响应中的similarity为0~1000的小数。
  • false表示响应中的similarity为0~100的整数。
support.huaweicloud.com/api-ivs/ivs_02_0028.html