ID Verification：FACE_LIVENESS_MIN

名称

类型

是否必选

描述

示例值

ProductCode

String

是

要接入的产品方案。取值FACE_LIVENESS_MIN：使用人脸静默活体API。

FACE_LIVENESS_MIN

SceneCode

String

否

您自定义的认证场景ID，用于后续控制台输入此场景ID查询相关记录使用。支持长度为10位的字母、数字或下划线的组合。

1234567890

MerchantBizId

String

是

您自定义的业务唯一标识，用于后续定位排查问题使用。支持长度为32位的字母和数字的组合，请确保唯一。

e0c34a77f5ac40a5aa5e6ed20c35****

MerchantUserId

String

是

您自定义的用户ID，或者其他可以识别特定用户的标识，例如：手机号码、邮箱地址等。强烈建议对该字段的值进行预先脱敏，例如对值进行哈希处理。

123456789

FacePictureBase64

String

是

照片Base64编码。如果您选择FacePictureBase64（照片Base64编码）方式传入人脸照片，请注意检查照片大小，不要传入过大的照片。

base64

FacePictureUrl

String

是

人像地址，公网可访问的HTTP、HTTPS链接。

https://***

FaceQuality

String

否

是否返回人脸质量分数，默认不返回。

• T：返回

• F：不返回

F

Crop

String

否

是否允许裁剪人脸图片，默认不允许。

• T：允许

• F：不允许

F

Occlusion

String

否

是否开启遮挡检测功能，默认不开启。

• T：开启

• F：不开启

F

名称

类型

描述

示例值

HTTP Status Code

Integer

HTTP状态码。

200

HTTP Body

RequestId

String

请求ID。

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

Result.TransactionId

String

整个认证流程的唯一标识。

hksb7ba1b28130d24e015d694361****

Code

String

返回Code。

Success

Message

String

返回Code的详细描述。

Success

Result.Passed

String

认证结果，取值：

• Y：通过

• N：不通过

Y

Result.SubCode

String

认证结果描述。更多信息，请参见ResultObject.SubCode错误码说明。

200

Result.ExtFaceInfo

String

静默活体检测相关结果信息。关于JSON格式，请参见右侧示例。更多信息，请参见ExtFaceInfo。

{
 "faceAttack": "N",
 "faceQualityScore": 88.62,
 "faceOcclusionResult": "N"
}