ID Verification:CheckResult

名前

型

必須

説明

例

MerchantBizId

String

はい

お客様のビジネス向けに定義する一意の識別子です。後続の問題の特定およびトラブルシューティングに使用します。値は、最大 32 文字の英数字の組み合わせである必要があります。一意性を確保してください。

e0c34a77f5ac40a5aa5e6ed20c35****

TransactionId

String

はい

hksb7ba1b28130d24e015d6********

IsReturnImage

String

いいえ

認証イメージを返すかどうかを指定します：

• Y： 必須

• N：返さない（デフォルト）

Y

名前

型

説明

例

HTTP ステータスコード

Integer

HTTP ステータスコードです。

200

HTTP ボディ

RequestId

String

リクエスト ID です。

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

Code

String

コードに戻る。

Success

Message

String

戻り値の Code の詳細な説明です。

success

Result.Passed

String

最終的な認証結果です。有効な値は以下のとおりです：

• Y: 合格

• N：失敗

Y

Result.SubCode

String

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

200

Result.ExtFaceInfo

String

顔のライブネス検証に関連する結果です。JSON 形式については、右側の例をご参照ください。詳細については、「ExtFaceInfo」をご参照ください。

{
  "faceAttack": "N",
  "faceImg": "/9j/4AAQSkZJRgABAQAAAQqviV6oakp8...",
  "docVideoUrl": "https://aliyun-cloudauth.oss-aliyuncs.com/******.webm" 
}

名前

型

説明

例

faceImg

String

Base64 形式のキャプチャ済み顔画像です。リクエストで IsReturnImage を Y に設定し、顔スキャンが完了した場合にこのフィールドが返されます。

Base64 形式

faceAttack

String

キャプチャ済み顔に対するライブネス攻撃の検出状況を示します。

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

• N：該当なし

N

docVideoUrl

String

https://aliyun-cloudauth.oss-aliyuncs.com/******.webm

faceAge

String

顔画像に基づく予測年齢（参考値）です。予測に失敗した場合は、このフィールドが返されない場合があります。

30

faceGender

String

顔画像に基づく予測性別です。予測に失敗した場合は、このフィールドが返されない場合があります。

• M：男性

• F：女性

M

faceAttackScore

Double

顔認識アルゴリズムによるなりすまし攻撃の発生確率です。数値が高いほど、なりすまし攻撃の可能性が高くなります。

値の範囲は 0 ～ 100 です。

80

guardRiskScore

Double

Face-Guard アルゴリズムによるデバイスリスクの発生確率です。数値が高いほど、デバイスリスクが高くなります。

値の範囲は 0 ～ 100 です。

90

faceComparisonScore

Double

顔照合のスコアです。認証に照合パターンが含まれる場合にのみ、このフィールドが返されます。

値の範囲は 0 ～ 100 です。デフォルトのシステムしきい値は 90 です。必要に応じて、判定基準をカスタマイズできます。

90

faceRegistrationResult

String

顔登録が成功したかどうかを示します。

• 1：成功

• 0：失敗

1

faceRegistrationID

String

顔登録の ID です。

顧客が自動登録を有効化し、顔登録が成功した場合にのみ、このフィールドが返されます。

f5a9219aefd6*******c84c8f0ca592a

duplicateFace

String

重複顔に関する情報です。

重複顔が検出された場合、顔データベース内の対応する顔の ID が返されます。

[
  {
    "faceGroupCode": "sg7****uzt",
    "faceId": "f5a921*******9e792ec84c8f0ca592a"
  }
]