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

功能描述

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

前提条件

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

输入限制

  • 图片格式:JPEG、JPG、PNG、BMP、GIF。
  • 图像大小:图像大小不超过3M。
  • 图像分辨率:不限制图片分辨率,但图片分辨率太高可能会导致API识别超时,超时时间为5秒。
  • URL地址中不能包含中文字符。

调试

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

请求参数

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

要执行的操作。取值:RecognizeIdentityCard。

ImageURL String https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/tiankong/7%E8%BA%AB%E4%BB%BD%E8%AF%81%E5%8E%9F%E5%9B%BE%20%281%29.jpeg

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

Side String face

身份证正反面类型。

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

返回数据

名称 类型 示例值 描述
Data Struct

返回的结果数据内容。

BackResult Struct

反面照结果。

EndDate String 19800101

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

Issue String 杭州市公安局

签发机关。

StartDate String 19700101

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

FrontResult Struct

正面照结果。

Address String 浙江省杭州市余杭区文一西路969号

地址信息。

BirthDate String 20000101

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

CardAreas Array of CardArea

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

X Float 165

身份证区域横坐标。

Y Float 657

身份证区域纵坐标。

FaceRectVertices Array of FaceRectVertice

人脸位置,四个顶点表示。

X Float 1024.6600341796875

人脸位置横坐标。

Y Float 336.629638671875

人脸位置纵坐标。

FaceRectangle Struct

人脸位置。

Angle Float -90

表示矩形顺时针旋转的度数,范围-180~180。

Center Struct

人脸矩形中心坐标。

X Float 952

人脸矩形中心横坐标。

Y Float 325.5

人脸矩形中心纵坐标。

Size Struct

人脸矩形尺寸。

Height Float 181.99

高度。

Width Float 164.99

宽度。

Gender String

性别。

IDNumber String 1234567890

身份证号。

Name String 张三

姓名。

Nationality String

民族。

RequestId String D6C24839-91A7-41DA-B31F-98F08EF80CC0

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=RecognizeIdentityCard
&ImageURL=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/tiankong/7%E8%BA%AB%E4%BB%BD%E8%AF%81%E5%8E%9F%E5%9B%BE%20%281%29.jpeg
&Side=face
&<公共请求参数>

正常返回示例

XML 格式

<RequestId>7E19E2CA-0BD2-4A3D-A96A-BA7CB5A8E5CD</RequestId>
<Data>
    <FrontResult>
        <Address>河北省邯郸市肥乡县肥乡镇</Address>
        <Gender>男</Gender>
        <Nationality>汉</Nationality>
        <Name>常涛</Name>
        <IDNumber>411526199706013217</IDNumber>
        <BirthDate>19970601</BirthDate>
    </FrontResult>
</Data>

JSON 格式

{
	"RequestId": "7E19E2CA-0BD2-4A3D-A96A-BA7CB5A8E5CD",
	"Data": {
		"FrontResult": {
			"Address": "河北省邯郸市肥乡县肥乡镇",
			"Gender": "男",
			"Nationality": "汉",
			"Name": "常涛",
			"IDNumber": "411526199706013217",
			"BirthDate": "19970601"
		}
	}
}

错误码

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

SDK参考

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

安全声明

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