本文介绍身份证识别RecognizeIdentityCard的语法及示例。

功能描述

身份证识别可以识别二代身份证关键字段内容,关键字段包括:姓名、性别、民族、身份证号、出生日期、地址信息、有效起始时间、签发机关,同时可输出身份证区域位置和人脸位置信息。

应用场景

远程注册:识别用户提交的身份证内容,自动完成用户身份信息填充。

特色优势

识别完整:支持识别身份证内各项内容。

前提条件

请确保您已开通文字识别服务,若未开通服务请立即开通

输入限制

  • 图像格式:JPEG、JPG、PNG、BMP、GIF。
  • 图像大小:不超过3M。
  • 图像分辨率:大于15×15像素,小于4096×4096像素。
  • URL地址中不能包含中文字符。

计费说明

关于身份证识别的计费方式及报价,请参见计费介绍

说明 下方调试接口为付费接口,如需免费体验调试请前往体验中心

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String RecognizeIdentityCard

系统规定参数。取值:RecognizeIdentityCard。

ImageURL String https://viapi-oss.oss-cn-shanghai.aliyuncs.com/doc/ocr/shenfz.jpg

图像URL地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL

Side String face

身份证正反面类型。

  • face:正面。
  • back:反面。

返回数据

名称 类型 示例值 描述
RequestId String D3F5BA69-79C4-46A4-B02B-58C4EEBC4C33

请求ID。

Data object

返回的结果数据内容。

BackResult object

反面照结果。

EndDate String 19800101

有效期结束时间,格式:YYYYMMDD,例如19800101,即1980年01月01日。

Issue String 杭州市公安局

签发机关。

StartDate String 19970101

有效期起始时间,格式:YYYYMMDD,例如19800101,即1980年01月01日。

FrontResult object

正面照结果。

FaceRectangle object

人脸位置。该字段已废弃。

Size object

人脸矩形尺寸。该字段已废弃。

Width Float 118.16333770751953

宽度。该字段已废弃。

Height Float 97.063156127929688

高度。该字段已废弃。

Angle Float -87.710586547851562

表示矩形顺时针旋转的度数,范围-180~180。该字段已废弃。

Center object

人脸矩形中心坐标。该字段已废弃。

Y Float 225.20643615722656

人脸矩形中心纵坐标。该字段已废弃。

X Float 475.59390258789062

人脸矩形中心横坐标。该字段已废弃。

BirthDate String 19960111

出生日期,格式:YYYYMMDD,例如19800101,即1980年01月01日。

Gender String

性别。

Address String 浙江省杭州市余杭区余杭小区6栋602

地址信息。

FaceRectVertices Array of FaceRectVertice

人脸位置,四个顶点表示。该字段已废弃。

Y Float 164.23321533203125

人脸位置纵坐标。该字段已废弃。

X Float 429.46124267578125

人脸位置横坐标。该字段已废弃。

CardAreas Array of CardArea

身份证区域位置,四个顶点表示,顺序是逆时针(左上、左下、右下、右上)。

Y Float 81

身份证区域纵坐标。

X Float 40

身份证区域横坐标。

Nationality String

民族。

Name String 张三

姓名。

IDNumber String 310228199601115411

身份证号。

示例

请求示例

http(s)://[Endpoint]/?Action=RecognizeIdentityCard
&ImageURL=https://viapi-oss.oss-cn-shanghai.aliyuncs.com/doc/ocr/shenfz.jpg
&Side=face
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<RequestId>D3F5BA69-79C4-46A4-B02B-58C4EEBC4C33</RequestId>
<Data>
    <FrontResult>
        <Address>浙江省杭州市余杭区余杭小区6栋602</Address>
        <FaceRectVertices>
            <X>521.7265625</X>
            <Y>286.1796569824219</Y>
        </FaceRectVertices>
        <FaceRectVertices>
            <X>424.7409362792969</X>
            <Y>282.30224609375</Y>
        </FaceRectVertices>
        <FaceRectVertices>
            <X>429.46124267578125</X>
            <Y>164.23321533203125</Y>
        </FaceRectVertices>
        <FaceRectVertices>
            <X>526.4468994140625</X>
            <Y>168.11062622070312</Y>
        </FaceRectVertices>
        <FaceRectangle>
            <Center>
                <X>475.5939025878906</X>
                <Y>225.20643615722656</Y>
            </Center>
            <Angle>-87.71058654785156</Angle>
            <Size>
                <Height>97.06315612792969</Height>
                <Width>118.16333770751953</Width>
            </Size>
        </FaceRectangle>
        <CardAreas>
            <X>40</X>
            <Y>81</Y>
        </CardAreas>
        <CardAreas>
            <X>588</X>
            <Y>80</Y>
        </CardAreas>
        <CardAreas>
            <X>588</X>
            <Y>400</Y>
        </CardAreas>
        <CardAreas>
            <X>40</X>
            <Y>401</Y>
        </CardAreas>
        <Gender>男</Gender>
        <Nationality>汉</Nationality>
        <Name>张三</Name>
        <IDNumber>310228199601115411</IDNumber>
        <BirthDate>19960111</BirthDate>
    </FrontResult>
</Data>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "D3F5BA69-79C4-46A4-B02B-58C4EEBC4C33",
  "Data" : {
    "FrontResult" : {
      "Address" : "浙江省杭州市余杭区余杭小区6栋602",
      "FaceRectVertices" : [ {
        "X" : 521.7265625,
        "Y" : 286.1796569824219
      }, {
        "X" : 424.7409362792969,
        "Y" : 282.30224609375
      }, {
        "X" : 429.46124267578125,
        "Y" : 164.23321533203125
      }, {
        "X" : 526.4468994140625,
        "Y" : 168.11062622070312
      } ],
      "FaceRectangle" : {
        "Center" : {
          "X" : 475.5939025878906,
          "Y" : 225.20643615722656
        },
        "Angle" : -87.71058654785156,
        "Size" : {
          "Height" : 97.06315612792969,
          "Width" : 118.16333770751953
        }
      },
      "CardAreas" : [ {
        "X" : 40,
        "Y" : 81
      }, {
        "X" : 588,
        "Y" : 80
      }, {
        "X" : 588,
        "Y" : 400
      }, {
        "X" : 40,
        "Y" : 401
      } ],
      "Gender" : "男",
      "Nationality" : "汉",
      "Name" : "张三",
      "IDNumber" : 310228199601115400,
      "BirthDate" : 19960111
    }
  }
}

错误码

关于身份证识别的错误码,详情请参见常见错误码

SDK参考

阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。