ID Verification：添加人脸图片到指定人脸库

名称

类型

描述

是否必填

示例值

ProductCode

string

产品代码。固定值：FACE_ENROLL

是

FACE_ENROLL

FaceGroupCode

string

人脸库编码。

是

sgl****7uc

MerchantUserId

string

自定义的用户唯一ID，不能超过32位。

• 若传入则优先以该userID注册；

• 若未传入则选择默认图片名。

否

130A2C10B9EE4D8488E35384FF03hst

FacePicture

string

人脸图片的base64编码。

否

base64

FacePictureUrl

string

人脸图片的URL。

否

https://example.com/test.jpg

FacePictureFileObject

InputStream

人脸图片的本地文件流。

使用此方式上传时，需通过云产品提供的 Advance 接口进行调用，并传入有效的 InputStream 对象。具体实现，请参见特殊场景：文件上传 Advance 接口配置。

否

图⽚的InputStream对象

FaceQualityCheck

string

是否检测人脸图片质量。

• Y：开启 （默认）

• N：关闭

开启后，系统将自动拦截模糊、遮挡等低质量的人脸照片，阻止其进入人脸库。拦截返回401（UnqualifiedPhoto）。

否

Y

名称

类型

描述

示例值

HTTP Status Code

integer

HTTP状态码。

200

HTTP Body

RequestId

string

请求ID。

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

Code

string

返回Code，具体信息请参见服务端返回HTTP状态码说明。

Success

Message

string

返回Code的详细描述。

请求成功

Result.Passed

string

注册结果。

• Y：注册成功

• N：注册失败

Y

Result.ExtFaceInfo

Object

人脸图片相关结果信息。关于JSON格式，请参见右侧示例。

更多信息，请参见ExtFaceInfo。

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