ID Verification：ID_OCR_MIN

名稱

類型

是否必選

描述

樣本值

ProductCode

String

是

要接入的產品方案。取值ID_OCR_MIN：使用證件OCR識別API。

ID_OCR_MIN

SceneCode

String

否

您自訂的認證情境ID，用於後續控制台輸入此情境ID查詢相關記錄。支援長度為10位的字母、數字和底線的組合。

1234567890

MerchantBizId

String

是

您自訂的業務唯一標識，用於後續定位排查問題。支援長度為32位的字母和數位組合，請確保唯一。

e0c34a77f5ac40a5aa5e6ed20c35****

MerchantUserId

String

是

您自訂的使用者ID，或者其他可以識別特定使用者的標識，例如：手機號碼、郵箱地址等。強烈建議對該欄位的值進行預先脫敏，例如對值進行雜湊處理。

123456789

IdOcrPictureBase64

String

否，三種上傳方式任選其一即可。

證件頭像面圖片Base64編碼。如果您選擇IdOcrPictureBase64（照片Base64編碼）方式傳入證件照片，請注意檢查照片大小，不要傳入過大的照片。

base64

IdOcrPictureUrl

String

證件頭像面圖片地址，公網可訪問的HTTP、HTTPS連結。

https://***

IdOcrPictureFile

InputStream

證件圖片檔案流。

具體接入方式，請參見特殊情境：檔案上傳 Advance 介面配置。

DocType

String

是

證件類型，以8位元字組合作為唯一標識，詳見證件類型列表。

F

Ocr

String

是

是否開啟OCR功能進行證件資訊自動提取。

• T：開啟OCR功能

• F：不開啟OCR功能

T

IdFaceQuality

String

否

是否返回證件人臉的品質分，預設不開啟。

• T：返回人臉品質分

• F：不返回

F

Spoof

String

否

是否開啟證件防偽功能，預設不開啟。

• T：開啟證件防偽功能

• F：不開啟

F

IdThreshold

String

否

3

CardSide

String

否

區分證件國徽面和人像面 ，不傳預設人像面 。

• OCR_ID_FACE （預設）：人像面

• OCR_ID_NATIONAL_EMBLEM ：國徽面

OCR_ID_NATIONAL_EMBLEM

名稱

類型

描述

樣本值

HTTP Status Code

Integer

HTTP狀態代碼。

200

HTTP Body

RequestId

String

請求ID。

130A2C10-B9EE-4D84-88E3-5384FF039****

Result.TransactionId

String

整個認證流程的唯一標識。

hksb7ba1b28130d24e015d694361b****

Code

String

返回Code，具體資訊請參見服務端返回HTTP狀態代碼說明。

Success

Message

String

返回Code的詳細描述。

success

Result.Passed

String

認證結果，取值：

• Y：通過

• N：不通過

Y

Result.SubCode

String

認證結果描述。更多資訊，請參見ResultObject.SubCode錯誤碼說明。

200

Result.ExtIdInfo

String

證件識別相關結果資訊。關於JSON格式，請參見右側樣本。更多資訊，請參見ExtIdInfo。

{
  "idFaceQualityScore": 98.0,
  "ocrIdInfo": {
    "expiryDate": "",
    "originOfIssue": "公安部出入境管理局",
    "englishName": "LI SI",
    "sex": "男",
    "name": "李四",
    "idNumber": "H11111112",
    "issueDate": "2013-01-02",
    "birthDate": "1990-02-21"
  },
  "spoofInfo": {
    "spoofResult": "Y",
    "spoofType": [
      "SCREEN_REMARK"
    ]
  }
}