フィールド
型
必須
説明
encrypted_video
String
Yes
暗号化された動画。暗号化方法の参照: 個人データの暗号化
return_image
boolean
No
選出されたフレーム画像と選出されたフレーム画像のタイムスタンプを返すかどうか。 デフォルト値は false で、値が true かつ生体認証が通過した場合に image_timestamp
, base64_image
フィールドが返されます
return_face_image
boolean
No
選出されたフレーム画像の顔のクロップを返すかどうか。 デフォルト値は false で、値が true かつ生体認証が通過した場合に base64_face_image
フィールドは返されます
return_status
boolean
No
エラーステータスの説明を返すかどうかを指定します。デフォルトはfalseで、値がtrueの場合にのみliveness_status
フィールドは返されます
フィールド
型
説明
request_id
string
リクエストのID
code
int
システムレスポンスコード: 1000
passed
boolean
生体認証に通過したかどうか
liveness_score
float
サイレント生体認証のスコア(参考までに、結果はpassedフィールドを使用してください)
liveness_status
string
サイレントライブネス検出のエラー状態を記述します。このフィールドは、return_status=true の時に返されます
image_timestamp
float
選出されたフレームのタイムスタンプを秒単位で表し、passed=true、return_image=trueの場合に返されます
base64_image
string
選出されたフレーム画像、passed=true、return_image=trueの場合は該当フィールドを返します
base64_face_image
string
選出された顔写真の切り抜き、passed=true、return_face_image=trueの場合に返されます
ステータス
説明
ok
サイレント生体認証は合格した: 動画の中の人は実在する
hack
サイレント生体認証は合格してない、理由: 捏造した顔 (例えば, ビデオで撮影された顔)
short_time
サイレント生体認証は合格してない、理由: ビデオの持続時間は2s未満
no_face_detected
サイレント生体認証は合格してない、理由: 映像から顔は検出されません
loss_tracking
サイレント生体認証は合格してない、理由: 途中で顔がフレームアウト
face_changed
サイレント生体認証は合格してない、理由: 動画の途中で顔が入れ替わっていました
face_occlusion
サイレント生体認証は合格してない、理由: 一定期間顔が見えなくなる
フィールド
型
説明
request_id
string
リクエストのID
code
int
システムレスポンスコード
message
string
エラーメッセージ
コード
フィールドの値
説明
1200
invalid argument
無効な入力パラメーター
2008
invalid video error
無効な動画
4007
liveness silent check failed
サイレント生体認証失敗
ステータスコード
ステータスフィールド
400
BAD_REQUEST
404
NOT_FOUND
411
LENGTH_REQUIRED
413
PAYLOAD_TOO_LARGE
500
INTERNAL_ERROR