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"
}