核身認(rèn)證移動端請求
本文介紹人臉人體(facebody)類目下的核身認(rèn)證移動端請求GenRealPersonVerificationToken的語法及示例。
功能描述
核身認(rèn)證移動端請求能力可以在移動端依據(jù)被驗(yàn)證的人名和身份證號碼,請求身份驗(yàn)證的用戶圖像信息。
- 您可以進(jìn)入在線咨詢獲取在線人工幫助。
- 阿里云視覺智能開放平臺視覺AI能力API接入、接口使用或問題咨詢等,請通過釘釘群(23109592)加入阿里云視覺智能開放平臺咨詢?nèi)郝?lián)系我們。
應(yīng)用場景
- 金融機(jī)構(gòu)網(wǎng)上開戶:在金融行業(yè)手機(jī)App注冊開戶,通過實(shí)人認(rèn)證,驗(yàn)證開戶用戶真實(shí)身份,降低運(yùn)營成本,提升風(fēng)控水平。
- 線上政務(wù)平臺注冊:疫情期間,政府在App中推出線上口罩預(yù)約功能,實(shí)施實(shí)人認(rèn)證,可有效防止同一人當(dāng)天重復(fù)領(lǐng)取口罩,導(dǎo)致分配不均。
- 修改密碼或手機(jī)號碼:在移動互聯(lián)網(wǎng)App修改密碼,或綁定手機(jī)號碼時,通過實(shí)人認(rèn)證進(jìn)行用戶真實(shí)身份確認(rèn)。
- 網(wǎng)約車司機(jī)認(rèn)證:網(wǎng)約車當(dāng)前運(yùn)營司機(jī)身份確認(rèn),防止冒用身份駕駛運(yùn)營車輛。
- 金融風(fēng)控:在支付、掛失、解凍、轉(zhuǎn)賬、取款、信貸、理財?shù)雀鱾€環(huán)節(jié)進(jìn)行用戶身份驗(yàn)證,做好金融風(fēng)險管控。
特色優(yōu)勢
- 金融級的指標(biāo):誤識率低于1/100000,準(zhǔn)確率高于99%。
- 成熟行業(yè)應(yīng)用:服務(wù)超過2億互聯(lián)網(wǎng)金融用戶,保障超過20億次交易安全。
- 秒級活體檢測:無需復(fù)雜交互動作,只需秒級即可完成活體檢測,更高效,同時也具備更高級別私密性,更高安全性。
- 通過金融級防攻擊測試:抵御各種真實(shí)發(fā)生的偽造攻擊,權(quán)威數(shù)據(jù)源驗(yàn)證。
- 低成本落地方案:純軟件方案,支持普通攝像頭,成本極低,適配室內(nèi)外。
- 國內(nèi)外權(quán)威認(rèn)證:通過公安部認(rèn)證、ISO 27001信息安全體系認(rèn)證,ISO30107-3人臉活體防攻擊認(rèn)證(iBeta PAD Level1), ISO/TC68。
接入指引
1. 注冊阿里云賬號:打開阿里云官網(wǎng),在阿里云官網(wǎng)右上角,單擊立即注冊,按照操作提示完成賬號注冊。
2. 請確保您已開通人臉人體服務(wù),若未開通服務(wù)請立即開通。
本能力支持企業(yè)或個人認(rèn)證用戶開通。更多實(shí)名認(rèn)證操作信息,請參見實(shí)名認(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)用方式包括以下幾種。
計費(fèi)說明
關(guān)于核身認(rèn)證移動端請求的計費(fèi)方式及報價,請參見計費(fèi)介紹。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數(shù)
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | GenRealPersonVerificationToken | 系統(tǒng)規(guī)定參數(shù)。取值:GenRealPersonVerificationToken。 |
CertificateName | String | 是 | 張三 | 被校驗(yàn)的身份證人名。 |
CertificateNumber | String | 是 | 33010219001123123X | 身份證號碼。 |
MetaInfo | String | 是 | {"dwe":"ew4e"...} | metainfo環(huán)境參數(shù),需要通過客戶端SDK獲取。Android SDK通過getMetaInfos獲取,iOS SDK通過getMetaInfo獲取。 |
返回數(shù)據(jù)
名稱 |
類型 |
示例值 |
描述 |
RequestId | String | A31006F2-22E7-4538-93BB-DE6B563643EE | 請求ID。 |
Data | Object | 返回的結(jié)果數(shù)據(jù)內(nèi)容。 |
|
VerificationToken | String | 9fca3791c158a479ead9f2ba65ab3XXX | 可信核身認(rèn)證的唯一標(biāo)識。 說明
|
SDK參考
阿里云視覺AI能力支持使用SDK調(diào)用,具體可參見:
示例
請求示例
http(s)://facebody.cn-shanghai.aliyuncs.com/?Action=GenRealPersonVerificationToken //更多關(guān)于endpoint信息,請參見:http://bestwisewords.com/document_detail/143103.html
&CertificateName=張三
&CertificateNumber=33010219001123123X
&MetaInfo={"dwe":"ew4e"...}
&公共請求參數(shù)
正常返回示例
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"
}
}
錯誤碼
關(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ù)支持工程師。(Z5136) |
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ī)。
- 通過體驗(yàn)調(diào)試上傳的臨時文件有效期為1小時,在24小時后會被系統(tǒng)自動清理刪除。
- 平臺不存儲用戶在使用服務(wù)過程中涉及的原始人臉圖片或文件信息。