人臉核身服務端
本文介紹人臉人體(facebody)類目下的人臉核身服務端ExecuteServerSideVerification的語法及示例。
功能描述
人臉核身服務端能力可以在服務端依據(jù)被驗證的人名和身份證號碼,請求身份驗證的用戶圖像信息。
- 您可以進入在線咨詢獲取在線人工幫助。
- 阿里云視覺智能開放平臺視覺AI能力API接入、接口使用或問題咨詢等,請通過釘釘群(23109592)加入阿里云視覺智能開放平臺咨詢群聯(lián)系我們。
應用場景
- 金融機構網(wǎng)上開戶:在金融行業(yè)手機App注冊開戶,通過實人認證,驗證開戶用戶真實身份,降低運營成本,提升風控水平。
- 線上政務平臺注冊:疫情期間,政府在App中推出線上口罩預約功能,實施實人認證,可有效防止同一人當天重復領取口罩,導致分配不均。
- 修改密碼或手機號碼:在移動互聯(lián)網(wǎng)App修改密碼,或綁定手機號碼時,通過實人認證進行用戶真實身份確認。
- 網(wǎng)約車司機認證:網(wǎng)約車當前運營司機身份確認,防止冒用身份駕駛運營車輛。
- 金融風控:在支付、掛失、解凍、轉賬、取款、信貸、理財?shù)雀鱾€環(huán)節(jié)進行用戶身份驗證,做好金融風險管控。
特色優(yōu)勢
- 金融級的指標:誤識率低于1/100000,準確率高于99%。
- 成熟行業(yè)應用:服務超過2億互聯(lián)網(wǎng)金融用戶,保障超過20億次交易安全。
- 秒級活體檢測:無需復雜交互動作,只需秒級即可完成活體檢測,更高效,同時也具備更高級別私密性,更高安全性。
- 通過金融級防攻擊測試:抵御各種真實發(fā)生的偽造攻擊,權威數(shù)據(jù)源驗證。
- 低成本落地方案:純軟件方案,支持普通攝像頭,成本極低,適配室內外。
- 國內外權威認證:通過公安部認證、ISO 27001信息安全體系認證,ISO30107-3人臉活體防攻擊認證(iBeta PAD Level1), ISO/TC68。
接入指引
1. 注冊阿里云賬號:打開阿里云官網(wǎng),在阿里云官網(wǎng)右上角,單擊立即注冊,按照操作提示完成賬號注冊。
2. 開通能力:請確保您已開通人臉人體服務,若未開通服務請立即開通。
本能力支持企業(yè)或個人認證用戶開通。更多實名認證操作信息,請參見實名認證。
3. 創(chuàng)建AccessKey:請確保您已創(chuàng)建AccessKey,如果您使用的是子賬號AccessKey,您需要給子賬號賦予AliyunVIAPIFullAccess權限,具體操作,請參見RAM授權。
4. 在線調試(可選):您可以通過OpenAPI Explorer在線調試能力,查看完整的調用示例代碼及SDK依賴信息,也可以下載完整的工程。
5. 開發(fā)接入步驟:
- 在SDK總覽中選擇您要接入使用的SDK語言。
- 在對應語言的SDK文檔中找到AI類目為人臉人體(facebody)的SDK包進行安裝。
- 參考文檔中提供的示例代碼進行適當修改后調用。
6. 客戶端直接調用:該能力常用的客戶端調用方式包括以下幾種。
輸入限制
- 圖像格式:僅支持JPG格式。
- 圖像大小:不超過1 MB。
- 圖片分辨率:大于640×480像素,小于2048×2048像素,長寬比小于等于2。
- URL地址中不能包含中文字符。
- 建議圖像中人臉五官區(qū)域輪廓完整,無明顯遮擋,圖片無旋轉。
計費說明
關于人臉核身服務端的計費方式及報價,請參見計費介紹。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求頭
該接口使用公共請求頭,無特殊請求頭。請參見公共請求參數(shù)文檔。
請求語法
POST /viapi/thirdparty/realperson/execServerSideVerification HTTP/1.1
請求參數(shù)
名稱 |
類型 |
位置 |
是否必選 |
示例值 |
描述 |
certificateName | String | FormData | 否 | 張三 | 真實姓名。 |
certificateNumber | String | FormData | 否 | 1281739873298172981 | 身份證號。 |
facialPictureData | String | FormData | 否 | /9j/wwew... | 與facialPictureUrl二選一。 待比對的圖像,Base64格式,只支持JPG格式圖片。必須是"/9j/"開頭,如非"/9j/"開頭請檢查是否為JPG格式圖片。文件的Base64編碼處理操作,請參見文件Base64處理。 |
facialPictureUrl | String | FormData | 否 | http://xxx.xxx.com/xxx.jpg | 與facialPictureData二選一。 待比對的圖像URL地址,只支持JPG格式圖片。推薦使用上海地域的OSS鏈接,對于文件在本地或者非上海地域OSS鏈接的情況,請參見文件URL處理。 |
sceneType | String | FormData | 否 | server | 場景類型,默認為 |
返回數(shù)據(jù)
名稱 |
類型 |
示例值 |
描述 |
RequestId | String | CE2FFC8A-6669-4F02-B4DA-95888087FBDC | 請求ID。 |
Data | Object | 返回的結果數(shù)據(jù)內容。 |
|
Pass | Boolean | true | 驗證是否成功。
|
VerificationToken | String | 6f1f730e732b232ccbdd85abc751**** | 驗證Token,主要用于排查問題。 |
Reason | String | 認證通過(Z8120) | 認證結果原因。
|
SDK參考
阿里云視覺AI能力支持使用SDK調用,具體可參見服務端接入教程下載安裝。
示例
請求示例
POST /viapi/thirdparty/realperson/execServerSideVerification HTTP/1.1
Host:facebody.aliyuncs.com
Content-Type:application/json
certificateName=張三&certificateNumber=1281739873298172981&facialPictureData=/9j/wwew...&facialPictureUrl=http://xxx.xxx.com/xxx.jpg&sceneType=server
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<RequestId>CE2FFC8A-6669-4F02-B4DA-95888087FBDC</RequestId>
<Data>
<Pass>true</Pass>
<VerificationToken>6f1f730e732b232ccbdd85abc751****</VerificationToken>
<Reason>認證通過(Z8120)</Reason>
</Data>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "CE2FFC8A-6669-4F02-B4DA-95888087FBDC",
"Data" : {
"Pass" : true,
"VerificationToken" : "6f1f730e732b232ccbdd85abc751****",
"Reason" : "認證通過(Z8120)"
}
}
錯誤碼
關于人臉核身服務端的錯誤碼如下表所示。
狀態(tài)碼 |
錯誤碼 |
描述 |
200 |
無錯誤碼 |
刷臉認證通過。 |
400 |
INVALID_PARAMETER |
初始化時傳入的參數(shù)不正確,請檢查各個傳參是否符合預期。(Z8121) |
200 |
無錯誤碼 |
刷臉認證未通過。抱歉,沒有認出您。(Z1146) |
500 |
PROCESSING |
刷臉認證未完成。請重試,如果一直不成功,聯(lián)系接口提供方技術人員排查。 |
500 |
PROCESSING |
圖片安全檢測不通過,請確認圖片是否為正常拍攝圖片。 |
500 |
PROCESSING |
系統(tǒng)出錯了,請您稍后再試,如果多次重試依然報錯,請記錄好RequestId聯(lián)系阿里云技術支持工程師。(Z5137) |
400 |
UNABLE_GET_IMAGE |
抱歉,您暫時無法使用刷臉服務。(Z1104) |
400 |
HIGH_RISK |
刷臉頻次過高或失敗次數(shù)過多,請您稍后再試。 |
400 |
PRODUCT_NOT_OPEN |
當前租戶未開通可信實人認證產(chǎn)品。 |
400 |
INITIALIZE_INVALID_SCENEID |
認證場景配置不存在,請先在控制臺上創(chuàng)建認證場景。(Z8107) |
400 |
INITIALIZE_INVALID_CERT_NAME |
姓名無效,請?zhí)顚懻_的姓名。(Z8109) |
400 |
INITIALIZE_INVALID_CERT_AGE |
未滿14周歲的用戶無法使用本產(chǎn)品,建議人工審核。(Z8110) |
400 |
INITIALIZE_INVALID_CERT_NO |
用戶身份證號碼信息無效,請?zhí)顚懻_的身份號碼信息。(Z8111) |
500 |
INVALID_INPUT_IMAGE |
圖片尺寸不合要求。(Z8125) |
500 |
EXTRACT_FACE_FAIL |
活體圖提取特征失敗。(Z1156) |
500 |
SYSTEM_ERROR |
初始化策略結果獲取失敗。(Z1146) |
安全聲明
- 請確保上傳的圖片或文件來源符合相應的法律法規(guī)。
- 通過體驗調試上傳的臨時文件有效期為1小時,在24小時后會被系統(tǒng)自動清理刪除。
- 平臺不存儲用戶在使用服務過程中涉及的原始人臉圖片或文件信息。