核身認(rèn)證移動端查詢
本文介紹人臉人體(facebody)類目下的核身認(rèn)證移動端查詢GetRealPersonVerificationResult的語法及示例。
功能描述
核身認(rèn)證移動端查詢能力可以確認(rèn)在證件合法且姓名匹配后,返回身份驗證的用戶圖像信息。
- 您可以進(jìn)入在線咨詢獲取在線人工幫助。
- 阿里云視覺智能開放平臺視覺AI能力API接入、接口使用或問題咨詢等,請通過釘釘群(23109592)加入阿里云視覺智能開放平臺咨詢?nèi)郝?lián)系我們。
接入指引
1. 注冊阿里云賬號:打開阿里云官網(wǎng),在阿里云官網(wǎng)右上角,單擊立即注冊,按照操作提示完成賬號注冊。
2. 開通能力:
- 請確保您已開通人臉人體服務(wù),若未開通服務(wù)請立即開通。
- 已按照App認(rèn)證接入教程完成客戶端數(shù)據(jù)采集。
本能力支持企業(yè)或個人認(rèn)證用戶開通。更多實名認(rèn)證操作信息,請參見實名認(rèn)證。
3. 創(chuàng)建AccessKey:請確保您已創(chuàng)建AccessKey,如果您使用的是子賬號AccessKey,您需要給子賬號賦予AliyunVIAPIFullAccess權(quán)限,具體操作,請參見RAM授權(quán)。
4. 在線調(diào)試(可選):您可以通過OpenAPI Explorer在線調(diào)試能力,查看完整的調(diào)用示例代碼及SDK依賴信息,也可以下載完整的工程。
5. 開發(fā)接入步驟:
- 在SDK總覽中選擇您要接入使用的SDK語言。
- 在對應(yīng)語言的SDK文檔中找到AI類目為人臉人體(facebody)的SDK包進(jìn)行安裝。
- 參考文檔中提供的示例代碼進(jìn)行適當(dāng)修改后調(diào)用。
6. 客戶端直接調(diào)用:該能力常用的客戶端調(diào)用方式包括以下幾種。
計費說明
人臉核身App認(rèn)證只計費發(fā)起核身認(rèn)證請求接口(GenRealPersonVerificationToken)的費用,查詢結(jié)果接口(GetRealPersonVerificationResult)不計費。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數(shù)
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | GetRealPersonVerificationResult | 系統(tǒng)規(guī)定參數(shù)。取值:GetRealPersonVerificationResult。 |
VerificationToken | String | 是 | cwek23dw24geor89230hf2rw | 可信核身認(rèn)證的唯一標(biāo)識。 說明 已認(rèn)證通過的VerificationToken不能做二次查詢校驗,否則會報錯。 |
返回數(shù)據(jù)
名稱 |
類型 |
示例值 |
描述 |
RequestId | String | 10FC953D-7C0C-4915-8949-34E3246E5B79 | 請求ID。 |
Data | Object | 返回的結(jié)果數(shù)據(jù)內(nèi)容。 |
|
Passed | Boolean | true | 認(rèn)證是否通過。
|
SDK參考
阿里云視覺AI能力支持使用SDK調(diào)用,具體可參見:
示例
請求示例
http(s)://facebody.cn-shanghai.aliyuncs.com/?Action=GetRealPersonVerificationResult //更多關(guān)于訪問域名(Endpoint)信息,請參見:http://m.bestwisewords.com/document_detail/143103.html
&VerificationToken=cwek23dw24geor89230hf2rw
&公共請求參數(shù)
正常返回示例
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
}
}
錯誤碼
關(guān)于核身認(rèn)證移動端查詢的錯誤碼如下表所示。
狀態(tài)碼 |
錯誤碼 |
描述 |
200 |
無錯誤碼 |
刷臉認(rèn)證通過。 |
400 |
INVALID_PARAMETER |
查詢時傳入?yún)?shù)不正確。聯(lián)系接口提供方技術(shù)人員排查。例如身份證格式不正確。(Z8105) |
400 |
NOT_SAME_PERSON |
刷臉認(rèn)證未通過,識別結(jié)果為非本人,請確認(rèn)是否為本人再發(fā)起認(rèn)證。抱歉,沒有認(rèn)出您。(Z1146) |
500 |
PROCESSING |
刷臉認(rèn)證未完成。請重試,如果一直不成功,聯(lián)系接口提供方技術(shù)人員排查。 |
500 |
PROCESSING |
圖片安全檢測不通過,請確認(rèn)圖片是否為正常拍攝圖片。(Z1146) |
500 |
PROCESSING |
系統(tǒng)出錯了,請您稍后再試,如果多次重試依然報錯,請記錄好RequestId聯(lián)系阿里云技術(shù)支持工程師。(Z5137) |
500 |
INVALID_PARAM |
抱歉,系統(tǒng)出錯了,請您稍后再試 ,如果多次重試依然報錯,請記錄好RequestId聯(lián)系阿里云技術(shù)支持工程師。(Z5132) |
400 |
UNABLE_GET_IMAGE |
比對源不可用。遠(yuǎn)程公安網(wǎng)沒有留底圖片,無法比對。請記錄好RequestId聯(lián)系阿里云技術(shù)支持工程師。(Z1104) |
400 |
HIGH_RISK |
刷臉頻次過高或失敗次數(shù)過多,請您24小時后再來嘗試。(Z1114) |
400 |
EXTRACT_FACE_FAIL |
圖片提取不到人臉特征,請確認(rèn)圖片中是否包含人臉信息。(Z1156) |
400 |
INITIALIZE_INVALID_CERT_NAME |
姓名無效,請?zhí)顚懻_的姓名。(Z8109) |
400 |
INITIALIZE_INVALID_CERT_AGE |
未滿14周歲的用戶無法使用本產(chǎn)品,建議人工審核。(Z8110) |
400 |
INITIALIZE_INVALID_CERT_NO |
用戶身份證號碼信息無效,請?zhí)顚懻_的身份號碼信息。(Z8111) |
400 |
QUERY_INVALID_CERTIFYID |
身份認(rèn)證記錄不存在,該CertifyId還沒有對應(yīng)的身份認(rèn)證提交記錄。(Z8304) |
400 |
QUERY_IMG_IS_NONE |
查詢不到照片或照片不可用,可能是公安庫數(shù)據(jù)問題導(dǎo)致。(Z8305) |
400 |
QUERY_CERTINFO_IS_NONE |
查詢不到身份信息,可能是用戶戶口遷移、軍人等特殊狀態(tài)導(dǎo)致。(Z8306) |
400 |
QUERY_CERTINFO_ISNOT_MATCH |
姓名和身份證不一致,可能是用戶的信息有誤或用戶的信息為假信息,建議用戶確認(rèn)后重新操作。(Z8307) |
400 |
QUERY_OCR_ISNOT_MATCH |
使用OCR方案時,人臉與身份證上人臉比對不一致,可能人證不符或人臉照片質(zhì)量較低,建議根據(jù)業(yè)務(wù)情況分層處理,若為同一人可重新操作。(Z8308) |
500 |
SYSTEM_ERROR |
查詢時發(fā)生系統(tǒng)錯誤。請重試,如果依然報錯,請記錄好RequestId聯(lián)系阿里云技術(shù)支持工程師。(Z5139) |
安全聲明
- 請確保上傳的圖片或文件來源符合相應(yīng)的法律法規(guī)。
- 通過體驗調(diào)試上傳的臨時文件有效期為1小時,在24小時后會被系統(tǒng)自動清理刪除。
- 平臺不存儲用戶在使用服務(wù)過程中涉及的原始人臉圖片或文件信息。