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