全部產品
Search
文件中心

ID Verification:CheckResult

更新時間:Dec 16, 2025

本文介紹如何通過CheckResult介面查詢證件OCR識別方案的認證結果。

介面說明

  • 介面名:CheckResult

  • 要求方法:HTTPS POST

  • 介面說明:當您收到回調通知之後,可以在服務端通過該介面擷取相應的認證結果。

    重要

    ID Verification服務結果預設儲存30天,超期系統自動刪除,請您在認證結束後的30天內查詢認證結果。

  • QPS限量:API獨享QPS限量,詳情請參見ID Verification服務端API QPS限量說明

  • 服務地址:

    說明

    內網指的是阿里雲同地區產品之間的內部通訊網路,如果您的商務服務器部署在阿里雲的對應地區,可以通過內網網域名稱訪問 ID Verification 服務,以獲得更安全、穩定的網路通訊品質。

    中國香港

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

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

線上調試和整合

說明

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

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

請求參數

名稱

類型

是否必選

描述

樣本值

MerchantBizId

String

Yes

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

說明

阿里雲伺服器不會對該欄位的值進行唯一性檢查。為了更好地跟蹤,強烈建議保證欄位唯一性。

e0c34a77f5ac40a5aa5e6ed20c35****

TransactionId

String

Yes

整個認證流程的唯一標識。該值需要調用 Initialize 介面擷取。

重要

為避免篡改風險,該值必須使用您Initialize介面時服務端儲存的TransactionId,不建議使用用戶端回調的TransactionId

hksb7ba1b28130d24e015d6********

IsReturnImage

String

No

是否需要返回認證圖片資料:

  • Y:需要

  • N:不需要(預設)

Y

返回資料

名稱

類型

描述

樣本值

HTTP Status Code

Integer

HTTP狀態代碼。

200

HTTP Body

RequestId

String

請求ID。

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

Code

String

返回Code

Success

Message

String

返回Code的詳細描述。

success

Result.Passed

String

認證最終結果。取值:

  • Y:通過

  • N:不通過

Y

Result.SubCode

String

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

200

Result.ExtIdInfo

String

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

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

ExtIdInfo

名稱

類型

描述

樣本值

ocrIdPassed

String

證件OCR識別階段的最終結果:

  • Y:通過

  • N:不通過

N

idImage

String

證件OCR照片,base64格式。例如在發起介面請求時,參數isReturnImage=Y且證件OCR流程順利完成,則返回此欄位。

base64

ocrIdInfo

String

證件OCR欄位資訊。更多資訊,請參見OCR識別返回欄位

說明

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

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

spoofInfo

String

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

說明

僅當Initialize介面中 IdSpoof = Y 時,才會開啟卡證檢測。

否則 spoofResult 預設返回NspoofType 為空白。

  • spoofResult:

    • Y存在風險

    • N正常

  • spoofType:

    • SCREEN_REMARK翻拍

    • PHOTO_COPY複印件

    • TAMPER:PS篡改

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

ocrIdEditInfo

String

在OCR結果頁二次編輯後,使用者提交的證件OCR欄位資訊。該功能適用用戶端配置選擇啟用OCR結果編輯頁面時(ShowOcrResult)返回。

說明

ShowOcrResult配置,Web SDK 接入在服務端Initialize介面中配置。

{
 "expiryDate": "2026-01-02",
 "originOfIssue": "公安部出入境管理局",
 "englishName": "ZHANG SAN",
 "sex": "男",
 "name": "張三",
 "idNumber": "H11111115",
 "issueDate": "2013-01-02",
 "birthDate": "1990-02-21"
 }

idBackImage

String

證件反面OCR照片,base64格式。

說明

如在發起介面請求時,參數isReturnImage = Y且證件OCR流程順利完成,則返回此欄位。

base64

ocrIdBackInfo

String

證件反面OCR欄位資訊。

重要

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

{
   "originOfIssue": "唐河縣公安局",
   "issueDate": "20230102",
   "expireDate": "20330102"
 }

spoofBackInfo

String

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

說明

僅當Initialize介面中 IdSpoof = Y 時,才會開啟卡證檢測。

否則 spoofResult 預設返回NspoofType 為空白。

  • spoofResult

    • Y:存在風險

    • N:正常

  • spoofType

    • SCREEN_REMARK:翻拍

    • PHOTO_COPY:複印件

    • TAMPER:PS篡改

說明

演算法預測結果,該欄位可能無法返回,建議業務上避免設定必要依賴。

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

返回Code

HTTP狀態代碼

Code

Message描述

200

Success

請求成功。

400

MissingParameter

參數不可為空。

InvalidParameter

非法參數。

TransactionIdInvalid

無效Transaction id。

403

Forbidden.RAMUserAccessDenied

需要給RAM使用者授予AliyunAntCloudAuthFullAccess的操作許可權。更多資訊,請參見授權RAM使用者訪問服務

Forbidden.AccountAccessDenied

確保您開通了ID verifycation,並且保證賬戶未欠費

Throttling.Api

API限流攔截。

404

ProcessNotCompleted

整個認證流程未完成。

500

InternalError

系統內部錯誤,請反饋工程師排查。

503

ServiceUnavailable

服務不可用,請反饋工程師排查。

ResultObject.SubCode錯誤碼說明

說明

Subcode基於不同產品方案或整合方式返回,詳情可參考下表。

適用方案

錯誤碼

認證記錄是否計費

描述和原因建議

通用

200

認證通過。

  • ID_OCR 純服務端接入(DocOcr)

  • ID_OCR_MAX

211

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

  • ID_OCR App(SDK)接入

  • ID_OCR Web(SDK)接入

  • ID_OCR_MAX

212

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

  • ID_OCR 純服務端接入(DocOcr)

  • ID_OCR_MAX

213

未檢測到指定對應證件類型(識別模式)或無法識別證件類型(分類模式)。

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

OCR識別返回欄位

中國香港居民身份證

說明

智能身份證2003和2018版本均支援。

欄位

類型

描述

name

String

姓名

englishName

String

姓名(英文)

nameCode

String

中文姓名電碼

sex

String

性別。取值:

  • M(男)

  • F(女)

birthDate

String

出生日期

idNumber

String

社會安全號碼碼

currentIssueDate

String

登記日期

firstIssueDate

String

首次登記的月份和年份

isPermanent

String

是否屬於永久性居民身份證。取值:

  • Y(是)

  • N(不是)

symbols

String

符號標記。如:“**AZ”。

往來港澳通行證

欄位

類型

描述

name

String

姓名

englishName

String

姓名(拼音)

sex

String

性別

birthDate

String

出生日期

idNumber

String

證件號碼

issueDate

String

簽發日期

expiryDate

String

失效日期

placeOfIssue

String

簽發地點

originOfIssue

String

簽發機關

港澳居民來往內地通行證

欄位

類型

描述

name

String

姓名

englishName

String

姓名(英文)

sex

String

性別

birthDate

String

出生日期

idNumber

String

證件號碼

issueDate

String

簽發日期

expiryDate

String

失效日期

originOfIssue

String

簽發機關

全球護照

說明

該證件類型通過識別全球ICAO協議樣式的e-Passport中MRZ標準協議內容,輸出固定格式的護照欄位,解決不同國家護照卡面內容格式差異帶來的相容性風險。

欄位

類型

描述

surname

String

姓(基於MRZ識別的拉丁文)

givenname

String

名(基於MRZ識別的拉丁文)

sex

String

性別(F或M)

birthDate

String

出生日期(yyyy-mm-dd 格式)

passportNo

String

護照號

nationality

String

國籍(3位元國家代碼)

expiryDate

String

失效日期(yyyy-mm-dd 格式)

countryCode

String

護照簽發機構所在國家代碼(3位元國

家代碼)

澳門居民身份證

欄位

類型

描述

surnameCN

String

姓(中文)

givennameCN

String

名(中文)

surname

String

姓(英文)

givenname

String

名(英文)

sex

String

性別

birthDate

String

出生日期

idNumber

String

證件號碼

expiryDate

String

失效日期

placeOfBirth

String

出生地代碼。如:“AS”。

中國台灣居民來往大陸通行證

欄位

類型

描述

name

String

姓名

englishName

String

姓名(拼音)

sex

String

性別

birthDate

String

出生日期

idNumber

String

證件號碼

issueDate

String

簽發日期

expiryDate

String

失效日期

originOfIssue

String

簽發機關

placeOfIssue

String

簽發地點

中華人民共和國居民身份證

欄位

類型

描述

name

String

姓名

sex

String

性別

ethnicity

String

民族

birthDate

String

出生日期

idNumber

String

社會安全號碼

address

String

地址