全部產品
Search

搜尋本產品

    ID Verification：ID_OCR_MIN

    文件中心

    ID Verification：ID_OCR_MIN

    更新時間：Sep 17, 2026

    本文介紹調用DocOcrV2介面的純服務端接入流程。通過該介面實現對身份證件圖片的資訊自動提取，及相關防偽風險判斷。

    介面說明

    • 介面名：DocOcrV2

    • 要求方法：HTTPS POST

    • 介面說明：調用DocOcrV2介面，通過OCR技術對各種身份證件（如護照、身份證等）進行自動資訊提取及相關防偽檢查。

    • QPS限量：API獨享QPS限量，詳情請參見服務端API QPS限量說明。

    • 服務地址：

      說明

      • 內網訪問優勢：內網指阿里雲同一地區內各產品間的私人通訊網路。若您的商務服務器部署於阿里雲對應地區，請使用內網網域名稱訪問 ID Verification 服務，以獲得更安全、穩定的通訊品質。 

      • 海外訪問最佳化建議：海外網路環境複雜，建議參考服務端網路耗時最佳化，最佳化整合方案，降低網路延遲及請求失敗機率。

      中國香港

      • 公網：cloudauth-intl.cn-hongkong.aliyuncs.com

      • 內網：cloudauth-intl-vpc.cn-hongkong.aliyuncs.com

    線上調試和整合

    說明

    在調試和整合前，請確保您已完整閱讀使用OpenAPI文檔，充分瞭解API介面在OpenAPI平台的調用方式和SDK及其代碼的擷取方式。

    您可以在OpenAPI Explorer中直接運行本介面進行調試，並產生本介面的SDK程式碼範例。

    傳入圖片格式要求

    為了確保模型效果穩定，請傳入滿足以下所有條件的圖片：

    • 圖片格式：JPG、JPEG、PNG。

    • 圖片大小：推薦50~100 KB，最大不超過1 MB。

      說明

      圖片轉base64格式後，通常會導致資料體積增加。如您需要使用base64格式傳參，請保證原始圖片的體積不超過0.6MB，以滿足1MB的最巨量資料傳輸限制。

    • 圖片解析度：圖片長寬需要大於 200像素，小於 8192 像素，推薦480*640（高*寬）。

    • 圖片品質建議：

      • 卡證圖片需要保持四個邊角完整，避免手持時遮擋影響檢測。

      • 卡證圖片內容清晰、無遮擋和無曝光光斑，卡證圖片角度正常，避免傾斜或者倒置。

      • 卡證圖片面積需要佔比圖片面積60%以上，避免卡面圖片面積過小影響識別。

      • 建議採用真實證件拍攝。

    請求參數

    名稱

    類型

    是否必選

    描述

    樣本值

    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位元字組合作為唯一標識，詳見證件類型列表。

    01000000

    Spoof

    String

    否

    【OCR配置】是否開啟證件防偽功能，預設開啟。

    說明

    僅證件人像面照片有效。

    • T：開啟證件防偽功能（預設）

    • F：不開啟

    F

    IdThreshold

    String

    否

    【OCR配置】是否開啟卡證品質檢測：

    • 1：開啟strict 模式

    • 2：開啟寬鬆模式（預設）

    • 3：關閉

    3

    CardSide

    String

    否

    【OCR配置】區分證件國徽面和人像面 ，不傳預設人像面 。

    • OCR_ID_FACE ：人像面（預設）

    • OCR_ID_NATIONAL_EMBLEM ：國徽面

    重要

    僅適用中華人民共和國居民身份證

    OCR_ID_NATIONAL_EMBLEM

    證件類型列表

    DocType

    對應證件

    01000000

    全球護照

    00000006

    中國香港居民身份證（2003版）

    00000008

    中國香港居民身份證（2018版）

    00000007

    往來港澳通行證

    00000009

    港澳居民來往內地通行證

    000000011

    中國澳門身份證

    000000012

    台灣居民來往大陸通行證

    00000001

    中國內地第二代居民身份證

    返回資料

    名稱

    類型

    描述

    樣本值

    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

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

    200

    Result.ExtIdInfo

    String

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

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

    ExtIdInfo

    名稱

    類型

    描述

    樣本值

    ocrIdInfo

    String

    證件OCR欄位資訊。更多資訊，請參見證件OCR欄位表（面向中資出海）。

    說明

    如果證件OCR流程失敗，則該欄位值為空白。 

    {
  "expiryDate": "",
  "originOfIssue": "公安部出入境管理局",
  "englishName": "LI SI",
  "sex": "男",
  "name": "李四",
  "idNumber": "H11111112",
  "issueDate": "2013-01-02",
  "birthDate": "1990-02-21"
}

    spoofInfo

    String

    證件防偽檢測結果，包括風險判定結果和風險類型：

    說明

    僅當入參中 Spoof = T時，才會開啟卡證檢測。

    否則 spoofResult 返回N，spoofType 為空白。

    • spoofResult：

      • Y：存在風險

      • N：正常

    • spoofType：

      • SCREEN_REMARK：翻拍

      • PHOTO_COPY：複印件

      • TAMPER：PS篡改

      • SHORTCUT：截屏

    {
 "spoofResult": "Y",
 "spoofType": ["SCREEN_REMARK"]
}

    Result.SubCode錯誤碼說明

    錯誤碼

    認證記錄是否計費

    描述和原因建議

    200

    是

    認證通過。

    211

    是

    【證件方案】證件圖片品質或解析度不符合要求，或者圖片本身不完整。請確保證件人像面照片清晰、曝光正常，完整無遮擋，角度無太大偏差。

    212

    是

    【證件方案】證件防偽檢測存在風險。可能存在翻拍、篡改、複印等高風險操作。

    213

    是

    【證件方案】未檢測到指定對應證件類型（識別模式）或無法識別證件類型（分類模式）。

    建議傳入清晰完整且角度正常的證件圖片。