本文介紹人臉人體(facebody)類目下的核身認證移動端請求GenRealPersonVerificationToken的語法及示例。
功能描述
核身認證移動端請求能力可以在移動端依據被驗證的人名和身份證號碼,請求身份驗證的用戶圖像信息。
- 您可以進入在線咨詢獲取在線人工幫助。
- 阿里云視覺智能開放平臺視覺AI能力API接入、接口使用或問題咨詢等,請通過釘釘群(23109592)加入阿里云視覺智能開放平臺咨詢群聯系我們。
應用場景
- 金融機構網上開戶:在金融行業手機App注冊開戶,通過實人認證,驗證開戶用戶真實身份,降低運營成本,提升風控水平。
- 線上政務平臺注冊:疫情期間,政府在App中推出線上口罩預約功能,實施實人認證,可有效防止同一人當天重復領取口罩,導致分配不均。
- 修改密碼或手機號碼:在移動互聯網App修改密碼,或綁定手機號碼時,通過實人認證進行用戶真實身份確認。
- 網約車司機認證:網約車當前運營司機身份確認,防止冒用身份駕駛運營車輛。
- 金融風控:在支付、掛失、解凍、轉賬、取款、信貸、理財等各個環節進行用戶身份驗證,做好金融風險管控。
特色優勢
- 金融級的指標:誤識率低于1/100000,準確率高于99%。
- 成熟行業應用:服務超過2億互聯網金融用戶,保障超過20億次交易安全。
- 秒級活體檢測:無需復雜交互動作,只需秒級即可完成活體檢測,更高效,同時也具備更高級別私密性,更高安全性。
- 通過金融級防攻擊測試:抵御各種真實發生的偽造攻擊,權威數據源驗證。
- 低成本落地方案:純軟件方案,支持普通攝像頭,成本極低,適配室內外。
- 國內外權威認證:通過公安部認證、ISO 27001信息安全體系認證,ISO30107-3人臉活體防攻擊認證(iBeta PAD Level1), ISO/TC68。
接入指引
1. 注冊阿里云賬號:打開阿里云官網,在阿里云官網右上角,單擊立即注冊,按照操作提示完成賬號注冊。
本能力支持企業或個人認證用戶開通。更多實名認證操作信息,請參見實名認證。
3. 創建AccessKey:請確保您已創建AccessKey,如果您使用的是子賬號AccessKey,您需要給子賬號賦予AliyunVIAPIFullAccess權限,具體操作,請參見RAM授權。
4. 在線調試(可選):您可以通過OpenAPI Explorer在線調試能力,查看完整的調用示例代碼及SDK依賴信息,也可以下載完整的工程。
5. 開發接入步驟:
- 在SDK總覽中選擇您要接入使用的SDK語言。
- 在對應語言的SDK文檔中找到AI類目為人臉人體(facebody)的SDK包進行安裝。
- 參考文檔中提供的示例代碼進行適當修改后調用。
6. 客戶端直接調用:該能力常用的客戶端調用方式包括以下幾種。
計費說明
關于核身認證移動端請求的計費方式及報價,請參見計費介紹。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | GenRealPersonVerificationToken | 系統規定參數。取值:GenRealPersonVerificationToken。 |
CertificateName | String | 是 | 張三 | 被校驗的身份證人名。 |
CertificateNumber | String | 是 | 33010219001123123X | 身份證號碼。 |
MetaInfo | String | 是 | {"dwe":"ew4e"...} | metainfo環境參數,需要通過客戶端SDK獲取。Android SDK通過getMetaInfos獲取,iOS SDK通過getMetaInfo獲取。 |
返回數據
名稱 |
類型 |
示例值 |
描述 |
RequestId | String | A31006F2-22E7-4538-93BB-DE6B563643EE | 請求ID。 |
Data | Object | 返回的結果數據內容。 |
|
VerificationToken | String | 9fca3791c158a479ead9f2ba65ab3XXX | 可信核身認證的唯一標識。 說明
|
SDK參考
阿里云視覺AI能力支持使用SDK調用,具體可參見:
示例
請求示例
http(s)://facebody.cn-shanghai.aliyuncs.com/?Action=GenRealPersonVerificationToken //更多關于endpoint信息,請參見:http://m.bestwisewords.com/document_detail/143103.html
&CertificateName=張三
&CertificateNumber=33010219001123123X
&MetaInfo={"dwe":"ew4e"...}
&公共請求參數
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<RequestId>A31006F2-22E7-4538-93BB-DE6B563643EE</RequestId>
<Data>
<VerificationToken>9fca3791c158a479ead9f2ba65ab3XXX</VerificationToken>
</Data>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "A31006F2-22E7-4538-93BB-DE6B563643EE",
"Data" : {
"VerificationToken" : "9fca3791c158a479ead9f2ba65ab3XXX"
}
}
錯誤碼
關于核身認證移動端請求的錯誤碼如下表所示。
狀態碼 |
錯誤碼 |
描述 |
200 |
無錯誤碼 |
刷臉認證通過。 |
400 |
INVALID_PARAMETER |
查詢時傳入參數不正確。聯系接口提供方技術人員排查。例如身份證格式不正確。(Z8105) |
400 |
NOT_SAME_PERSON |
刷臉認證未通過,識別結果為非本人,請確認是否為本人再發起認證。抱歉,沒有認出您。(Z1146) |
500 |
PROCESSING |
刷臉認證未完成。請重試,如果一直不成功,聯系接口提供方技術人員排查。 |
500 |
PROCESSING |
圖片安全檢測不通過,請確認圖片是否為正常拍攝圖片。(Z1146) |
500 |
PROCESSING |
系統出錯了,請您稍后再試,如果多次重試依然報錯,請記錄好RequestId聯系阿里云技術支持工程師。(Z5137) |
500 |
INVALID_PARAM |
抱歉,系統出錯了,請您稍后再試 ,如果多次重試依然報錯,請記錄好RequestId聯系阿里云技術支持工程師。(Z5132) |
400 |
UNABLE_GET_IMAGE |
比對源不可用。遠程公安網沒有留底圖片,無法比對。請記錄好RequestId聯系阿里云技術支持工程師。(Z1104) |
400 |
HIGH_RISK |
刷臉頻次過高或失敗次數過多,請您24小時后再來嘗試。(Z1114) |
400 |
EXTRACT_FACE_FAIL |
圖片提取不到人臉特征,請確認圖片中是否包含人臉信息。(Z1156) |
400 |
INITIALIZE_INVALID_CERT_NAME |
姓名無效,請填寫正確的姓名。(Z8109) |
400 |
INITIALIZE_INVALID_CERT_AGE |
未滿14周歲的用戶無法使用本產品,建議人工審核。(Z8110) |
400 |
INITIALIZE_INVALID_CERT_NO |
用戶身份證號碼信息無效,請填寫正確的身份號碼信息。(Z8111) |
400 |
QUERY_INVALID_CERTIFYID |
身份認證記錄不存在,該CertifyId還沒有對應的身份認證提交記錄。(Z8304) |
400 |
QUERY_IMG_IS_NONE |
查詢不到照片或照片不可用,可能是公安庫數據問題導致。(Z8305) |
400 |
QUERY_CERTINFO_IS_NONE |
查詢不到身份信息,可能是用戶戶口遷移、軍人等特殊狀態導致。(Z8306) |
400 |
QUERY_CERTINFO_ISNOT_MATCH |
姓名和身份證不一致,可能是用戶的信息有誤或用戶的信息為假信息,建議用戶確認后重新操作。(Z8307) |
400 |
QUERY_OCR_ISNOT_MATCH |
使用OCR方案時,人臉與身份證上人臉比對不一致,可能人證不符或人臉照片質量較低,建議根據業務情況分層處理,若為同一人可重新操作。(Z8308) |
500 |
SYSTEM_ERROR |
查詢時發生系統錯誤。請重試,如果依然報錯,請記錄好RequestId聯系阿里云技術支持工程師。(Z5139) |
安全聲明
- 請確保上傳的圖片或文件來源符合相應的法律法規。
- 通過體驗調試上傳的臨時文件有效期為1小時,在24小時后會被系統自動清理刪除。
- 平臺不存儲用戶在使用服務過程中涉及的原始人臉圖片或文件信息。