本文介紹人臉人體(facebody)類目下的核身認證移動端查詢GetRealPersonVerificationResult的語法及示例。
功能描述
核身認證移動端查詢能力可以確認在證件合法且姓名匹配后,返回身份驗證的用戶圖像信息。
- 您可以進入在線咨詢獲取在線人工幫助。
- 阿里云視覺智能開放平臺視覺AI能力API接入、接口使用或問題咨詢等,請通過釘釘群(23109592)加入阿里云視覺智能開放平臺咨詢群聯系我們。
接入指引
1. 注冊阿里云賬號:打開阿里云官網,在阿里云官網右上角,單擊立即注冊,按照操作提示完成賬號注冊。
2. 開通能力:
本能力支持企業或個人認證用戶開通。更多實名認證操作信息,請參見實名認證。
3. 創建AccessKey:請確保您已創建AccessKey,如果您使用的是子賬號AccessKey,您需要給子賬號賦予AliyunVIAPIFullAccess權限,具體操作,請參見RAM授權。
4. 在線調試(可選):您可以通過OpenAPI Explorer在線調試能力,查看完整的調用示例代碼及SDK依賴信息,也可以下載完整的工程。
5. 開發接入步驟:
- 在SDK總覽中選擇您要接入使用的SDK語言。
- 在對應語言的SDK文檔中找到AI類目為人臉人體(facebody)的SDK包進行安裝。
- 參考文檔中提供的示例代碼進行適當修改后調用。
6. 客戶端直接調用:該能力常用的客戶端調用方式包括以下幾種。
計費說明
人臉核身App認證只計費發起核身認證請求接口(GenRealPersonVerificationToken)的費用,查詢結果接口(GetRealPersonVerificationResult)不計費。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | GetRealPersonVerificationResult | 系統規定參數。取值:GetRealPersonVerificationResult。 |
VerificationToken | String | 是 | cwek23dw24geor89230hf2rw | 可信核身認證的唯一標識。 說明 已認證通過的VerificationToken不能做二次查詢校驗,否則會報錯。 |
返回數據
名稱 |
類型 |
示例值 |
描述 |
RequestId | String | 10FC953D-7C0C-4915-8949-34E3246E5B79 | 請求ID。 |
Data | Object | 返回的結果數據內容。 |
|
Passed | Boolean | true | 認證是否通過。
|
SDK參考
阿里云視覺AI能力支持使用SDK調用,具體可參見:
示例
請求示例
http(s)://facebody.cn-shanghai.aliyuncs.com/?Action=GetRealPersonVerificationResult //更多關于訪問域名(Endpoint)信息,請參見:http://bestwisewords.com/document_detail/143103.html
&VerificationToken=cwek23dw24geor89230hf2rw
&公共請求參數
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<GetRealPersonVerificationResultResponse>
<RequestId>10FC953D-7C0C-4915-8949-34E3246E5B79</RequestId>
<Data>
<Passed>true</Passed>
</Data>
</GetRealPersonVerificationResultResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "10FC953D-7C0C-4915-8949-34E3246E5B79",
"Data" : {
"Passed" : true
}
}
錯誤碼
關于核身認證移動端查詢的錯誤碼如下表所示。
狀態碼 |
錯誤碼 |
描述 |
200 |
無錯誤碼 |
刷臉認證通過。 |
400 |
INVALID_PARAMETER |
查詢時傳入參數不正確。聯系接口提供方技術人員排查。例如身份證格式不正確。(Z8105) |
400 |
NOT_SAME_PERSON |
刷臉認證未通過,識別結果為非本人,請確認是否為本人再發起認證。抱歉,沒有認出您。(Z1146) |
500 |
PROCESSING |
刷臉認證未完成。請重試,如果一直不成功,聯系接口提供方技術人員排查。 |
500 |
PROCESSING |
圖片安全檢測不通過,請確認圖片是否為正常拍攝圖片。(Z1146) |
500 |
PROCESSING |
系統出錯了,請您稍后再試,如果多次重試依然報錯,請記錄好RequestId聯系阿里云技術支持工程師。(Z5137) |
500 |
INVALID_PARAM |
抱歉,系統出錯了,請您稍后再試 ,如果多次重試依然報錯,請記錄好RequestId聯系阿里云技術支持工程師。(Z5136) |
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小時后會被系統自動清理刪除。
- 平臺不存儲用戶在使用服務過程中涉及的原始人臉圖片或文件信息。