ID Verification:指定した顔グループへの顔画像の追加

パラメーター

タイプ

説明

必須

例

ProductCode

string

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

はい

FACE_ENROLL

FaceGroupCode

string

顔グループのコード。

はい

sgl****7uc

MerchantUserId

string

ユーザーのカスタム一意 ID。最大長は 32 文字です。

• 指定した場合、この ID が登録に使用されます。

• 省略した場合、システムはデフォルトの ID を生成します。

いいえ

130A2C10B9EE4D8488E35384FF03hst

FacePicture

string

顔画像の Base64 エンコード文字列。

いいえ

base64

FacePictureUrl

string

顔画像の URL。

いいえ

https://example.com/test.jpg

FacePictureFileObject

InputStream

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

このパラメーターを使用してファイルをアップロードするには、Advance API を呼び出し、有効な InputStream オブジェクトを渡す必要があります。詳細については、「特殊なシナリオ：ファイルアップロードのための Advance API の設定」をご参照ください。

いいえ

画像の InputStream オブジェクト

FaceQualityCheck

string

顔画像の画質をチェックするかどうかを指定します。

• Y：画質チェックを有効にします (デフォルト)。

• N：画質チェックを無効にします。

有効にすると、ぼやけている、またはオクルージョンがあるなどの低画質の画像をシステムが自動的に拒否し、顔グループに追加しません。拒否された画像に対しては、システムは 400 (UnqualifiedPhoto) エラーを返します。

いいえ

Y

パラメーター

タイプ

説明

例

HTTP ステータスコード

integer

HTTP ステータスコード。

200

HTTP ボディ

RequestId

string

リクエスト ID。

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

Code

string

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

Success

Message

string

リターンコードの説明。

The request was successful.

Result.Passed

string

登録結果。

• Y：登録に成功しました。

• N：登録に失敗しました。

Y

Result.ExtFaceInfo

Object

顔画像分析結果が含まれます。JSON 形式については、例をご参照ください。

詳細については、「ExtFaceInfo」をご参照ください。

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