ID Verification:FACE_IDU_MIN

名前

タイプ

必須

説明

例

ProductCode

String

はい

製品コード。値を FACE_IDU_MIN に設定します。

FACE_IDU_MIN

MerchantBizId

String

はい

ビジネス固有のカスタム識別子。後続の問題特定やトラブルシューティングに使用されます。値は、長さが 32 文字の英数字の組み合わせです。値が一意であることを確認してください。

e0c34a77f5ac40a5aa5e6ed20c35****

MerchantUserId

String

はい

ユーザー固有のカスタム ID、または携帯電話番号やメールアドレスなど、特定のユーザーを識別できるその他の識別子。事前にハッシュ化などの方法で値を非識別化することを強く推奨します。

123456789

VerifyModel

String

はい

検証モード：

• 0：検索モード

  • 機能：顔グループとユーザー顔画像 (SourceFacePicture/SourceFacePictureUrl/SourceFacePictureFile) を渡すと、システムが自動的に顔グループを検索し、顔画像がすでに存在するかどうかを判定します。ユーザー顔画像はサイレント生体検知に対応しています。

  • 推奨シナリオ：重複登録が許可されていない実在人物アカウントの登録。

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

  • 機能：指定した顔画像 (SourceFacePicture/SourceFacePictureUrl/SourceFacePictureFile) と参照顔画像 (TargetFacePicture/TargetFacePictureUrl/TargetFacePictureFile) を渡すと、システムが自動的に2つの画像の顔情報が一致するかどうかを検証します。指定した顔画像はサイレント生体検知に対応しています。

  • 推奨シナリオ：ログイン認証情報、アカウント情報などを変更する際に、オペレーターの身元を検証する必要があるシナリオ。

• 2：総合モード

  • 機能：顔グループ、指定した顔画像 (SourceFacePicture/SourceFacePictureUrl/SourceFacePictureFile)、および参照顔画像 (TargetFacePicture/TargetFacePictureUrl/TargetFacePictureFile) を渡すと、システムが自動的に顔グループ内で指定した顔画像を検索し、参照顔画像と一致するかどうかを確認します。指定した顔画像はサイレント生体検知に対応しています。

  • 推奨シナリオ：ユーザーが新規ユーザーであり、かつ正当なオペレーターであることを検証する必要があるシナリオ。

0

FaceGroupCodes

String

いいえ

ID Verification コンソールで顔グループを作成する際に取得するコードです。最大 10 個の顔グループを同時にクエリできます。複数の顔グループコードはカンマ (,) で区切ります。

1232344,23444

SourceFacePicture

String

いいえ

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

base64

SourceFacePictureUrl

String

いいえ

顔画像の URL。HTTP または HTTPS 経由で公開アクセス可能である必要があります。

https://***face1.jpeg

SourceFacePictureFile

String

いいえ

顔画像ファイルストリーム。

顔画像ファイルストリーム 1

TargetFacePicture

String

いいえ

Base64 エンコードされた参照 (ターゲット) 顔画像。

base64

TargetFacePictureUrl

String

いいえ

参照 (ターゲット) 顔画像の URL。HTTP または HTTPS 経由で公開アクセス可能である必要があります。

https://***face2.jpeg

TargetFacePictureFile

String

いいえ

参照 (ターゲット) 顔画像ファイルストリーム。

顔画像ファイルストリーム 2

AutoRegistration

String

いいえ

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

• 0：自動登録

• 1：登録しない (デフォルト)

0

FaceRegisterGroupCode

String

いいえ

登録用の顔グループ。

0e0c34a77f

ReturnFaces

String

いいえ

一致しきい値を超える複数の顔が存在する場合に返す顔の数。

• デフォルト値：1

• 最大値：5

1

FaceQualityCheck

String

いいえ

N

名前

タイプ

説明

例

HTTP ステータスコード

Integer

HTTP ステータスコード。

200

HTTP ボディ

RequestId

String

リクエストの ID。

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

Code

String

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

Success

Message

String

リターンコードの詳細な説明。

success

Result.FacePassed

String

最終的な認証結果。有効な値：

• Y： 合格。

• N： 不合格。

Y

Result.FaceComparisonScore

Double

VerifyModel が 1 または 2 に設定されている場合に返されます。1対1 検証の比較スコア。有効な値：0～100。

98

Result.DuplicateFace

String

検索中に重複顔が見つかった場合に返されます。顔グループ内の対応する顔の顔 ID、ユーザー ID、および比較スコアが返されます。

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

Result.FaceRegistrationResult

Integer

顔登録の結果。

• 0：失敗

• 1：成功

1

Result.FaceRegistrationId

String

自動登録が有効で、顔が正常に登録された場合に返されます。対応する FACEID が返されます。

9e792******a592a

Result.FaceAttack

String

キャプチャされた顔が生体攻撃の対象かどうかを示します。Y は攻撃を示し、N は攻撃がないことを示します。サイレント生体検知が有効になっている場合に返されます。

N

Result.FaceAge

String

予測年齢。予測に失敗した場合、このフィールドは返されないことがあります。

30

Result.FaceGender

String

予測された性別。予測に失敗した場合、このフィールドは返されないことがあります。

• M：男性

• F：女性

M

Result.SubCode

String

認証結果の説明。詳細については、「SubCode」セクションをご参照ください。

200

Result.TransactionId

String

認証リクエストの一意の識別子。

4ab0b***cbde97

Result.ExtFaceInfo

Object

生体検知結果情報。JSON 形式については、右側の例をご参照ください。詳細については、「ExtFaceInfo」セクションをご参照ください。

{
  "FaceQualityScore": 66.3,
  "OcclusionScore": 100,
  "SharpnessScore": 70.3,
  "KaOcclusionScore": 80,
  "IlluminationScore": 90.79
}

名前

タイプ

説明

例

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