3.1 /liveness/silent_detection/stateless
サイレント生体検知のインターフェースです。
動画の規格は、運用マニュアルの3章 写真と動画の規格をご参照ください。
リクエストモード
POST
リクエスト URL
リクエストパラメーター
フィールド | 型 | 必須 | 説明 |
encrypted_video | string | Yes | 暗号化された動画。暗号化方法の参照: 個人データの暗号化 |
return_image | boolean | No | 選出されたフレーム写真と選出されたフレーム写真のタイムスタンプを返すかどうかを指定します。デフォルト値はfalseで、値がtrueかつ生体認証が通過した場合に |
return_face_image | boolean | No | 選出されたフレーム写真の顔のクロップを返すかどうかを指定します。。 デフォルト値はfalseで、値がtrueかつ生体認証が通過した場合に |
return_status | boolean | No | エラーステータスの説明を返すかどうかを指定します。デフォルトはfalseで、値がtrueの場合にのみ |
通常のレスポンス
フィールド | 型 | 説明 |
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の場合に返されます |
request_id | string | リクエストのID |
ここでliveness_status
の結果は以下のようになります:
ステータス | 説明 |
ok | サイレント生体認証は合格:動画の中の人は実在する |
hack | サイレント生体認証は不合格。理由:捏造した顔 (例えば, ビデオで撮影された顔) |
short_time | サイレント生体認証は不合格。理由:顔を含めるビデオの持続時間は2s未満 |
異常なレスポンス
フィールド | 型 | 説明 |
code | int | システムレスポンスコード |
message | string | エラーメッセージ |
request_id | string | リクエストのID |
システムレスポンスコードの説明
コード | フィールドの値 | 説明 |
1200 | invalid argument | 無効な入力パラメーター |
2008 | invalid video error | 無効な動画(ビデオの持続時間は2s未満) |
4007 | liveness silent check failed | サイレント生体認証に失敗 |
可能なHTTPステータスコード
ステータスコード | ステータスフィールド |
400 | BAD_REQUEST |
404 | NOT_FOUND |
411 | LENGTH_REQUIRED |
413 | PAYLOAD_TOO_LARGE |
500 | INTERNAL_ERROR |
サンプル
Last updated