API: Factor/raw_video - 活體檢測(cè)
概覽
Factor/raw_video
是submail的活體檢測(cè)API,檢查用戶拍攝的視頻是否為活體。
URL
<主> http://tpa.mysubmail.com/factor/raw_video
<備> https://tpa.mysubmail.com/factor/raw_video
http 請(qǐng)求方式
請(qǐng)求方式 | content-type 設(shè)置 |
---|---|
http post | multipart/form-data 、x-www-form-urlencoded 、application/json |
signature創(chuàng)建規(guī)則
1. 請(qǐng)將以下參數(shù)按照字段升序(A-Z)排列 appkey 、timestamp
2. 創(chuàng)建簽名字符串 :以"key=value" + "&"(連接符)+ "key=value" 的方式連接所有參數(shù)
3. 創(chuàng)建簽名:拼接簽名字符串示例string = "appkey=xxxx×tamp=xxxxxxxxxx",然后使用sha256(string)創(chuàng)建簽名
注:中文需要使用urlencode處理后再參與創(chuàng)建簽名
請(qǐng)求參數(shù)
參數(shù) | 類型 | 是否必需 | 默認(rèn) | 描述 |
---|---|---|---|---|
appid | string | 必需 | 無 | 在 SUBMAIL 身份認(rèn)證服務(wù)中創(chuàng)建并且認(rèn)證通過的應(yīng)用 ID |
timestamp | string | 必需 | 無 | UNIX 時(shí)間戳 |
signature | string | 必需 | 無 | 簽名,詳細(xì)規(guī)則看下方介紹 |
motions | string | 必需 | 無 | 用戶動(dòng)作序列,BLINK 眨眼;MOUTH 張嘴; NOD 點(diǎn)頭; YAW 搖頭 |
complexity | string | 必需 | 無 | 活體檢測(cè)通過的難易程度,默認(rèn)為 0, 0:簡(jiǎn)單模式;1: 正常模式;2:困難模式;3:地獄模式 |
image_flag | string | 必需 | 無 | 是否需要返回照片,Y/N |
video | file | 必需 | 無 | 視頻文件 |
返回參數(shù)格式
jsonString
代碼示例
詳情請(qǐng)查詢demo示例文檔
響應(yīng)消息
API請(qǐng)求失敗
{
'status' : 'error' , // 狀態(tài)描述
'send_id' : 'ee05d1635db847a2bf3c8317434539d6', // API流水號(hào)
'code' : 1201 , // API返回的狀態(tài)碼 詳情查看 API錯(cuò)誤代碼與描述 文檔
'msg' : 'Incorrect APP ID.' , // API返回的描述、
}
API請(qǐng)求成功
{
'status' : 'success' , // 狀態(tài)描述
'send_id' : 'ee05d1635db847a2bf3c8317434539d6', // API流水號(hào)
'result' : {
'identical' => true //驗(yàn)證是否通過 true/false
'status'=>'01' //驗(yàn)證是否通過 01通過 / 02不通過
'featureImage' => ... //image_flag為N返回空,為Y返回圖片的base64編碼
};
}