文档
测试

活体检测随机码

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

接口描述

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

请求头

参数名
类型
描述
必填
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的使用说明 > <font color='red'>在之后的接口请求中,都应该在头部带上Authorization参数,参数值以Bearer加空格开头,后接{{token}} 例如:Bearer 8d1630b2-7920-4ccd-bf37-e3309f9fdd4f</font> 获取access_token,参考“[Access Token获取](doc:xI1yQhUy)” ## 响应说明 - **通用响应体参数说明** – requestid:唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 requestid – code:平台响应码,0-成功,其他见响应码表 – message:响应描述,大写SUCCESS表示成功,错误信息描述展示于此 – data:业务响应内容体,以json格式为主,如faceid返回结构含result、description字段 – timestamp:时间戳 – extra:扩展信息 - **请求示例** ``` http://host:port/rest/faceid/validatecode?type=0 ``` - **响应示例** ``` { "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": {} } ```