本文介紹如何通過調用InitFaceVerify接口發起金融級NFC認證請求。
發起認證請求
接口名:InitFaceVerify。
全局接入地址:cloudauth.aliyuncs.com(IPv4)或cloudauth-dualstack.aliyuncs.com(IPv6)
請求方法:POST和GET。
傳輸協議:HTTPS。
接口說明:每次開始認證前通過本接口獲取CertifyId,用來串聯認證請求中的各個接口。
QPS限量:API獨享QPS限量,詳情請參見服務端接口QPS限量說明。
請求參數
名稱 | 類型 | 是否必選 | 描述 | 示例值 |
SceneId | Long | 是 | 認證場景ID。該ID在控制臺創建認證場景后自動生成。關于如何創建認證場景,請參見添加認證場景。 | 100000**** |
OuterOrderNo | String | 是 | 您自定義的業務唯一標識,用于后續定位排查問題使用。支持最長為32位長度的字母和數字組合,請確保唯一。 | e0c34a77f5ac40a5aa5e6ed20c35**** |
ProductCode | String | 是 | 認證方案。 唯一取值:NFC_QY。 | NFC_QY |
UserId | String | 是 | 您自定義的用戶ID,請保持唯一。 | 12345**** |
CertType | String | 是 | 證件類型。 說明 當前僅支持護照認證。 | PASSPORT |
ReadImg | String | 是 | 是否讀取證件照片。 Y:讀取。 N:不讀取。 說明 如果在后續認證環節需要使用證件人臉照片,此處建議入參為Y。 | Y |
MetaInfo | String | 是 | MetaInfo環境參數。需要通過客戶端SDK獲取,詳情請參見App(SDK)接入。 |
說明 示例僅供參考,實際集成中不能直接應用,具體參考SDK集成說明獲取。 |
Mode | String | 否 | 獲取護照NFC核驗要素方式:
說明 NFC解碼護照芯片加密信息時需要獲取護照三要素信息,包括姓名、出生日期和證件有效截止日期。 | 1 |
CertNo | String | 否 | 證件號碼。 當證件類型CertType取值PASSPORT,并且Mode取值為3時,此字段必填。 | E123456**** |
CertName | String | 否 | 證件上的姓名。 | 張三 |
Birthday | String | 否 | 證件上的出生日期。 當證件類型CertType取值PASSPORT,并且Mode取值為3時,此字段必填。 | 1993-10-10 |
ValidityDate | String | 否 | 證件有效截止日期。 當證件類型CertType取值PASSPORT,并且Mode取值為3時,此字段必填。 | 2039-06-10 |
Mobile | String | 否 | 終端用戶的手機號碼。 | 1304567**** |
Ip | String | 否 | 終端用戶的IP。 | 114.112.XX.XX |
CallbackToken | String | 否 | 安全Token,由您自行生成,用于防重復、防篡改校驗。 如果設置了該值會在回調地址顯示CallbackToken字段。 | NMjvQanQgplBSaEI0sL86WnQplB |
callbackUrl | String | 否 | 認證結果的回調通知地址,必須以HTTPS開頭。 | https://www.aliyun.com |
AuthId | String | 否 | 用戶授權ID,最大長度為64位字符。 | 92d46b9e9e2d703f2897f350d5bd4149 |
?返回數據
名稱 | 類型 | 是否必選 | 描述 | 示例值 |
RequestId | String | 是 | 本次請求的ID。 | 130A2C10-B9EE-4D84-88E3-5384FF03**** |
Message | String | 否 | 請求消息的響應信息。 | success |
Code | String | 是 | 返回碼。關于返回碼的具體內容,請參見返回Code和Message說明。 | 200 |
ResultObject.CertifyId | String | 否 | 實人認證唯一標識。客戶端通過verify()函數發起NFC認證的時候需傳入該參數。 重要
| 91707dc296d469ad38e4c5efa6a0**** |
?返回Code和Message說明
Code | Message | 描述 |
200 | success | 成功。 |
400 | 參數不能為空 | 參數不能為空。 |
401 | 參數非法 | 非法參數。傳入的姓名、身份證號碼、證件號長度、出生日期等必須符合國家標準的特殊字符。 |
402 | 應用配置不存在 | 應用配置不存在。 |
404 | 認證場景配置不存在 | 認證場景配置不存在,請先在控制臺上創建認證場景。 |
410 | 未開通服務 | 未開通OSS產品或未完成OSS讀寫授權,請登錄控制臺完成授權。具體操作,請參見授權金融級實人認證訪問OSS存儲空間。 |
411 | RAM無權限 | 需要給RAM用戶授予AliyunAntCloudAuthFullAccess的操作權限。 |
412 | 欠費中 | 金融級NFC認證或OSS存在欠費,請充值后操作。 |
414 | 設備不支持NFC | 當前移動設備不支持NFC認證,請更換設備后操作。 |
418 | NFC失敗次數過多 | NFC認證失敗次數過多。 |
500 | 系統錯誤 | 系統內部錯誤,請通過智能在線聯系阿里云工程師協助排查。 |
?