ID Verification:FACE_IDU_MIN

パラメーター

タイプ

必須

説明

例

ProductCode

String

はい

プロダクトコードです。値を FACE_IDU_MIN に設定します。

FACE_IDU_MIN

SceneCode

String

いいえ

カスタムの検証シナリオ ID。

1234567890

MerchantBizId

String

はい

追跡とトラブルシューティングのために定義する一意のビジネス ID。32 文字の英数字の文字列である必要があります。この ID が一意であることを確認してください。

e0c34a77f5ac40a5aa5e6ed20c35****

MerchantUserId

String

はい

特定のユーザーのカスタムユーザー ID またはその他の識別子 (携帯電話番号やメールアドレスなど)。この値はハッシュ化するなどして、脱感作することを強く推奨します。

123456789

VerifyModel

String

はい

検証タイプ。

• 0：検索モード

  • 機能：顔グループとユーザーの顔画像 (SourceFacePicture/SourceFacePictureUrl) を提供します。システムは顔グループを検索し、顔画像が既に存在するかどうかをチェックします。ユーザーの顔画像に対してサイレント生体検知を有効にできます。

  • 推奨ユースケース：重複登録が許可されていない実在人物のアカウント登録。

• 1：検証モード (デフォルト)

  • 機能：ソース顔画像 (SourceFacePicture/SourceFacePictureUrl) とターゲット顔画像 (TargetFacePicture/TargetFacePictureUrl) を提供します。システムは 2 つの顔が一致するかどうかを検証します。ソース顔画像に対してサイレント生体検知を有効にできます。

  • 推奨ユースケース：ログイン認証情報やアカウント情報の変更時など、アカウント所有者が操作を行っていることを確認する場合。

• 2：統合モード

  • 機能：顔グループ、ソース顔画像 (SourceFacePicture/SourceFacePictureUrl)、およびターゲット顔画像 (TargetFacePicture/TargetFacePictureUrl) を提供します。システムは顔グループでソース顔を検索し、ターゲット顔と一致するかどうかを検証します。ソース顔画像に対してサイレント生体検知を有効にできます。

  • 推奨ユースケース：ユーザーが新規であり、かつアクションを実行している人物が同一人物であることを確認する場合。

0

Liveness

String

いいえ

サイレント生体検知を有効にするかどうかを指定します。

• 0：無効

• 1：有効

0

FaceGroupCodes

String

いいえ

顔グループのコード。これらのコードは、顔グループを作成する際に ID Verification コンソールから取得できます。一度に最大 10 個の顔グループをクエリできます。複数のコードはカンマで区切ります。

1232344,23444

SourceFacePicture

String

いいえ

Base64 エンコードされた顔画像。

base64

SourceFacePictureUrl

String

いいえ

顔画像の URL。URL は、パブリックにアクセス可能な HTTP または HTTPS リンクである必要があります。

https://***face1.jpeg

TargetFacePicture

String

いいえ

Base64 エンコードされた顔画像。

base64

TargetFacePictureUrl

String

いいえ

顔画像の URL。URL は、パブリックにアクセス可能な HTTP または HTTPS リンクである必要があります。

https://***face2.jpeg

AutoRegistration

String

いいえ

検索中に顔が見つからなかった場合に、指定された顔グループに顔を自動登録するかどうかを指定します。

• 0：自動登録を有効にする。

• 1：自動登録を無効にする (デフォルト)。

0

FaceRegisterGroupCode

String

いいえ

登録用の顔グループ。

0e0c34a77f

SaveFacePicture

String

いいえ

このパラメーターは予約済みであり、まだ有効ではありません。

FaceVerifyThreshold

String

いいえ

このパラメーターは予約済みであり、まだ有効ではありません。

ReturnFaces

String

いいえ

一致しきい値を超える複数の顔が見つかった場合、このパラメーターを使用して返す顔の数を指定できます。

• デフォルト：1

• 最大：5

1

パラメーター

タイプ

説明

例

HTTP ステータスコード

Integer

HTTP ステータスコード。

200

HTTP Body

RequestId

String

リクエスト ID。

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

Code

String

レスポンスコード。

Success

Message

String

レスポンスコードの詳細な説明。

success

Result.FacePassed

String

検証の最終結果。有効な値：

• Y：合格

• N：不合格

Y

Result.FaceComparisonScore

String

1:1 検証の比較スコア。このパラメーターは、VerifyModel が 1 または 2 に設定されている場合に返されます。値の範囲は 0 から 100 です。

98

Result.DuplicateFace

String

検索中に重複した顔が見つかった場合、このパラメーターは顔グループから対応する顔 ID、ユーザー ID、および比較スコアを返します。

[
  {
    "faceGroupCode": "sg7****uzt",
    "faceId": "f5a921*******9e792ec84c8f0ca592a"
    "merchantUserId":"face0005",
    "score":93.26
  }
]

Result.FaceRegistrationResult

String

顔登録の結果。

• 0：失敗

• 1：成功

1

Result.FaceRegistrationId

String

自動登録が有効で成功した場合に返される顔 ID。

9e792******a592a

Result.FaceAttack

String

なりすまし攻撃が検出されたかどうかを示します。Y：攻撃を検出。N：攻撃は検出されませんでした。このパラメーターは、サイレント生体検知が有効な場合に返されます。

N

Result.FaceAttackScore

String

顔がなりすまし攻撃の一部である確率。値の範囲は 0 から 100 です。このパラメーターは、サイレント生体検知が有効な場合に返されます。

99

Result.FaceAge

String

推定される顔の年齢。予測に失敗した場合、このパラメーターは空または省略されることがあります。

30

Result.FaceGender

String

予測される顔の性別。予測に失敗した場合、このパラメーターは空または省略されることがあります。

• M：男性

• F：女性

M

Result.SubCode

String

検証結果のエラーコード。詳細については、「サブコード」をご参照ください。

200

Result.TransactionId

String

検証リクエストの一意の ID。

4ab0b***cbde97