調用ContrastFaceVerify接口通過傳入圖片進行實人認證。
傳入圖片格式要求
傳入人臉圖片時，支持人臉順時針旋轉90度、180度和270度，多人臉的情況會選取最大人臉。
當您在進行實人認證的時候，請傳入滿足以下所有條件的圖片：
認證主體的近期照片，人臉需要完整清晰無遮擋、表情自然且正對攝像頭。
照片清晰、曝光正常，臉部無過黑、過亮、光暈等情況、角度無太大偏差。
分辨率不超過1920*1080（高*寬），至少為640*480，推薦短邊縮放到720像素，壓縮率大于0.9。照片高大于寬，如果傳入的照片寬大于高，可能會影響檢測效果。
照片大小需要小于1 MB。
示例：
接口說明
接口名：ContrastFaceVerify。
全局接入地址：cloudauth.aliyuncs.com（IPv4）或cloudauth-dualstack.aliyuncs.com（IPv6）
請求方法：POST和GET。
傳輸協議：HTTPS。
接口說明：通過傳入圖片進行實人認證。
QPS限量：API獨享QPS限量，詳情請參見服務端接口QPS限量說明。
請求參數
名稱 | 類型 | 是否必選 | 描述 | 示例值 |
SceneId | Long | 是 | 認證場景ID。該ID在控制臺創建認證場景后自動生成。關于如何創建認證場景，請參見添加認證場景。 | 100000**** |
OuterOrderNo | String | 是 | 客戶服務端自定義的業務唯一標識，用于后續定位排查問題使用。值最長為32位長度的字母數字組合，請確保唯一。 | e0c34a77f5ac40a5aa5e6ed20c35**** |
ProductCode | String | 是 | 認證方案。 唯一取值：ID_MIN。 | ID_MIN |
Model | String | 否 | 活體檢測類型。取值：
| FRONT_CAMERA_LIVENESS |
CertType | String | 是 | 用戶證件類型。支持的證件類型，請參見方案概述。 不同證件類型，取值均為IDENTITY_CARD。 | IDENTITY_CARD |
CertName | String | 是 | 真實姓名。 | 張三 |
CertNo | String | 是 | 證件號碼。 | 1******************9 |
DeviceToken | String | 否 | 當前用戶設備的Token，用于風險識別。 | McozS1ZWRcRZStlERcZZo_QOytx5jcgZoZJEoRLOxxxxxxx |
Mobile | String | 否 | 用戶手機號碼。 | 1390000**** |
Ip | String | 否 | 用戶IP。 | 114.100.XX.XX |
UserId | String | 否 | 客戶業務自定義的用戶ID。 | 148562088256**** |
FaceContrastPicture | String | 是 說明 您需要在下述四種傳入人臉照片方式中，選擇其中一種：
如果您選擇OSS方式傳入人臉照片，您必須傳入OssBucketName和OssObjectName參數。OSS請求參數格式僅支持開通實人認證服務時授權的OSS生成的URL、Bucket和Object。 | 照片Base64編碼。如果您選擇FaceContrastPicture（照片Base64編碼）方式傳入人臉照片，請注意檢查照片大小，不要傳入過大的照片；您可以通過OSS方式上傳較大的人臉照片。 | /9j/4AAQSkZJRgABAQAASxxxxxxx |
FaceContrastPictureUrl | String | 人像地址，公網可訪問的HTTP、HTTPS鏈接。 | https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/verify/xxxxx/xxxxx.jpeg | |
CertifyId | String | 之前實人認證通過的CertifyId，認證時的照片作為比對照片。您需要確保傳入CertifyId關聯的圖片正常存儲在授權的OSS Bucket中。 | 0bfa7c493f850e5178b9f8613634**** | |
OssBucketName | String | 已授權OSS空間的Bucket名稱。 | cn-shanghai-aliyun-cloudauth-xxxxx | |
OssObjectName | String | 已授權OSS空間的Object名稱。 | verify/xxxxx/xxxxxx.jpeg | |
Crop | String | 否 | 是否允許裁剪人臉圖片，默認不允許。
說明 若您請求的圖片并非來自標準活體檢測SDK采集，建議您允許裁剪人臉圖片。 開啟該功能后，將會對請求的圖片先進行人臉裁剪與矯正，完成后會發起請求服務。 | T |
EncryptType | String | 否 | 加密類型。為空表示不加密。 如開啟加密傳輸，需傳入加密算法。目前僅支持SM2國密算法。 如需傳入加密算法，需對CertName和CertNo進行加密，并傳入加密后的密文。有關參數加密的更多信息，請參見參數加密說明。 | SM2 |
返回參數
名稱 | 類型 | 是否必選 | 描述 | 示例值 |
RequestId | String | 是 | 請求ID。 | 130A2C10-B9EE-4D84-88E3-5384FF039795 |
Message | String | 否 | 請求的響應信息。 | success |
Code | String | 是 | 返回碼，200指接口響應成功。詳細認證結果判斷，請參見下文ResultObject.SubCode錯誤碼說明。 | 200 |
ResultObject.Passed | String | 是 | 認證結果。取值：
說明 判斷認證結果請以ResultObject.Passed字段為準。 | T |
ResultObject.SubCode | String | 否 | 認證結果描述，請參見ResultObject.SubCode錯誤碼說明。 說明 判斷認證結果請以ResultObject.Passed字段為準。 | 200 |
ResultObject.IdentityInfo | String | 否 | 認證的主體信息，目前支持的認證場景返回為空。 | 無 |
ResultObject.MaterialInfo | String | 否 | 認證主體附件信息，主要為圖片類材料，使用JSON結構體轉換的字符串表示，請參見ResultObject.MaterialInfo的JSON格式示例。 | {\"faceAttack\":\"F\",\"faceOcclusion\":\"F\",\"facialPictureFront\":{\"faceAttackScore\":0.261962890625,\"qualityScore\":54.81831741333008,\"verifyScore\":19.0}} |
ResultObject.MaterialInfo的JSON格式示例說明：
{ // 是否為攻擊：攻擊為T，非攻擊為F。 "faceAttack": "F", // 是否有臉部遮擋：有臉部遮擋為T，否則為F。 "faceOcclusion": "F", "facialPictureFront": { // 人臉攻擊分。 "faceAttackScore": 0.00008597839769208804， // 活體人臉質量分數。 "qualityScore": 88.3615493774414, // 人臉和公安比對分數，閾值可參考下表詳細說明。 "verifyScore": 50.28594166529785 } }verifyScore閾值說明：
千分之一誤識率
萬分之五誤識率
萬分之一誤識率
十萬分之五誤識率
十萬分之一誤識率
70
71.5
75
76.5
80
說明如果您有個性化需求，您可以根據業務情況，參考返回的比對分和閾值，自定義認證結果。
返回Code和Message說明
Code | Message | 描述 |
200 | success | 請求響應成功。 |
400 | 參數不能為空 | 參數不能為空。 |
401 | 參數非法 | 非法參數。傳入的姓名、身份證號碼長度必須符合國家標準且不得包含英文字母等特殊字符。 |
402 | 應用配置不存在 | 應用配置不存在。 |
404 | 認證場景配置不存在 | 認證場景配置不存在，請先在控制臺上創建認證場景。具體操作，請參見添加認證場景。 |
410 | 未開通服務 | 未開通OSS產品或未完成OSS讀寫授權，請登錄控制臺完成授權。 |
411 | RAM無權限 | 需要給子賬號授予AliyunAntCloudAuthFullAccess的操作權限。 |
412 | 欠費中 | 金融級實人認證或OSS存在欠費，請充值后操作。 |
417 | 無法使用刷臉服務 | 當前身份信息比對源不可用。若信息正確，建議人工審核。 |
418 | 刷臉失敗次數過多 | 當天刷臉認證次數過多，請明天再試。 說明 一個身份信息在一天內最多可以認證失敗20次，無法調整更多的認證失敗次數。 |
419 | 傳入圖片不可用 | 圖片無法下載、圖片內容為空、圖片分辨率不符合要求或提取不到人臉特征，建議更換圖片。 |
420 | 數據重復 | 您通過多種方式傳入了認證材料。目前支持以下四種方式中的一種傳入認證材料：
|
421 | 傳入圖片過大 | 圖片超過了1 MB，建議壓縮圖片或更換圖片上傳方式。 |
422 | 下載圖片超時 | 圖片下載超過了3秒，請排查網絡后重新操作。 |
423 | 狀態錯誤 | 傳入的CertifyId認證狀態需要為T（認證通過），您也可以更換其他方式傳入圖片。 |
500 | 系統錯誤 | 系統內部錯誤，請通過智能在線聯系阿里云工程師協助排查。 |
ResultObject.SubCode錯誤碼說明
錯誤碼 | 認證描述文案 | 是否計費 | 可能原因和運營建議 |
200 | 認證通過 | 是 | 無。 |
201 | 姓名和身份證不一致 | 是 | 可能是用戶的信息有誤或用戶的信息為假信息，建議用戶確認后重新操作。若同一身份信息重復發起認證，服務端初始化將會返回417錯誤。 |
202 | 查詢不到身份信息 | 是 | 可能是用戶戶口遷移等特殊狀態導致，建議預留人工審核入口，進行人工審核。若同一身份信息重復發起認證，服務端初始化將會返回417錯誤。 |
203 | 查詢不到照片或照片不可用 | 是 | 可能是公安庫數據問題導致，建議預留人工審核入口，進行人工審核。若同一身份信息重復發起認證，服務端初始化將會返回417錯誤。 |
204 | 人臉比對不一致 | 是 | 可能不是同一人或活體照片質量較低，建議根據業務情況分層處理，若為同一人可重復操作。 |
205 | 活體檢測存在風險 | 是 | 可能存在攻擊風險，建議人工審核分層處理，若為真人可重復操作。 |
206 | 業務策略限制 | 是 | 為了保證認證的安全性，會對認證的設備、身份、人臉等環境進行安全檢測，若檢測到可能存在風險會判定認證結果不通過。您可以按照如下方法排查處理：
|
209 | 權威比對源異常 | 是 | 可能存在權威比對源異常，無法比對。 |