ID Verification:FACE_LIVENESS_MIN_PRO

名前

タイプ

必須

説明

例

ProductCode

String

はい

製品ソリューションコード。固定値：FACE_LIVENESS_MIN_PRO。

FACE_LIVENESS_MIN_PRO

MerchantBizId

String

はい

トラッキング用のカスタムビジネス識別子。英数字で最大 32 文字。一意である必要があります。

e0c34a77f5ac40a5aa5e6ed20c35****

MerchantUserId

String

はい

カスタムユーザー識別子 (携帯電話番号やメールアドレスなど)。送信前にこの値をハッシュ化してください。

123456789

FacePictureBase64

String

いいえ

Base64 エンコードされた顔画像。1 MB の制限を超えないように、送信前にサイズを確認してください。

base64

FacePictureUrl

String

いいえ

一般公開されている顔画像の URL。

https://***

FacePictureFile

InputStream

いいえ

ファイルストリームとしての顔画像。

顔画像の InputStream オブジェクト。

FaceQualityCheck

String

いいえ

N

名前

タイプ

説明

例

HTTPステータスコード

Integer

HTTPステータスコード。

200

HTTPボディ

RequestId

String

リクエスト ID。

130A2C10-B9EE-4D84-88E3-5384FF0****

Result.TransactionId

String

検証プロセスの一意のID。

hksb7ba1b28130d24e015d694361****

Code

String

リターンコード：詳細については、「サーバーサイドの HTTP ステータスコード」をご参照ください。

Success

Message

String

リターンコードを説明するメッセージ。

Success

Result.Passed

String

認証結果：

• Y：成功。

• N：失敗。

Y

Result.SubCode

String

認証結果の説明。詳細については、「ResultObject.SubCode エラーコード」をご参照ください。

200

Result.ExtFaceInfo

Object

JSON 形式のサイレントライブネス検出の詳細。フィールドについては、「ExtFaceInfo フィールド」をご参照ください。

{
  "FaceQualityScore": 76.69,
  "OcclusionResult": "N",
  "FaceAttack": "N",
  "SharpnessScore": 60.78,
  "KaOcclusionScore": 100,
  "FaceGender": "M",
  "OcclusionScore": 99.99,
  "FaceAge": 28,
  "IlluminationScore": 97.43
}

エラーコード

課金対象

説明と推奨事項

200

はい

認証が成功しました。

205

はい

ライブネス検出でリスクが検出されました。

名前

タイプ

説明

例

FaceQualityScore

Double

顔品質スコア。範囲：0～100。高いほど良いです。

88.62

OcclusionScore

Double

オクルージョンのサブスコア。範囲：0～100。高いほど良いです。

99.99

KaOcclusionScore

Double

キーエリアのオクルージョンのサブスコア。範囲：0～100。高いほど良いです。

100

IlluminationScore

Double

照明のサブスコア。範囲：0～100。高いほど良いです。

97.43

SharpnessScore

Double

シャープネスのサブスコア。範囲：0～100。高いほど良いです。

60.78

FaceAttack

String

ライブネス攻撃が検出されたかどうか。

• Y：攻撃が検出されました。

• N：攻撃は検出されませんでした。

N

FaceAge

Integer

予測された年齢。予測に失敗した場合は空になることがあります。

30

FaceGender

String

予測された性別。予測に失敗した場合は空になることがあります。

• M：男性。

• F：女性。

M