全部产品
Search

搜索本产品

    ID Verification：ID_OCR_MIN

    文档中心

    ID Verification：ID_OCR_MIN

    更新时间：Sep 16, 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：开启严格模式

    • 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

    是

    【证件方案】未检测到指定对应证件类型（识别模式）或无法识别证件类型（分类模式）。

    建议传入清晰完整且角度正常的证件图片。