文档
测试

活体检测随机码

GET
http://host:port/rest/faceid/validatecode

接口描述

此接口主要用于生成随机码,用于视频的语音/动作识别校验使用,以判断视频的即时性,而非事先录制的,提升作弊的难度。

Header

参数名
类型
描述
必填
Authorization
string
通过API Key和Secret Key获取的access_token,参考“Access Token获取”(本地版不需传输)
必填
Content-Type
string
application/json
必填

请求参数

参数名
类型
描述
必填
type
int
0为语音验证和唇语验证码, 1为视频动作活体。 默认0
必填

响应参数

参数名
类型
描述
必填
session_id
string
随机校验码会话id,有效期5分钟,请提示用户在五分钟内完成全部操作 验证码使用过即失效,每次使用视频活体前请重新拉取验证码
必填
code
string
随机验证码:4位数字或动作顺序(逗号分隔):0:眨眼 1:张嘴 2:闭眼 3:右转 4:左转 5:抬头 6:低头 7:左右转
必填

说明 / 示例

###### token的使用方法(本地版不需传输) >d 在之后的接口请求中,都应该在头部带上Authorization参数,参数值以Bearer加空格开头,后接{{token}} 例如:Bearer 8d1630b2-7920-4ccd-bf37-e3309f9fdd4f 获取access_token,参考[“Access Token获取”](doc:6hjVner7) 签名算法,请查看文档:[签名算法](doc:MHaXIJs8) ### 响应说明 中科软开放平台所有API采用通用响应体包含业务响应信息构建而成。 - **通用响应体内通用参数说明:** -- **requestid**:唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 requestid -- **code**:平台响应码,0-成功,其他见响应码表 -- **message**:响应描述,大写SUCCESS表示成功,错误信息描述展示于此 -- **data**:业务响应内容体,以json格式为主,如faceid返回结构含result、description字段 -- **timestamp**:时间戳 -- **extra**:扩展信息 ###### 返回示例: ``` { "requestid": "f904f4cf-75db-4f8f-a5ec-dc4f942c7f7a", "code": 0, "message": "SUCCESS", "data": { "session_id": "S59faeeebb9111890355690", //会话ID "code": "9940" //当为视频动作活体时,返回值的代表所需动作和动作顺序。 0:眨眼 1:张嘴 2:闭眼 3:右转 4:左转 5:抬头 6:低头 7:左右转 }, "timestamp": 1509617387, "extra": {} } ```