身份证信息识别技术文档和开发接口调用代码

识别二代身份证关键字段内容，关键字段包括：姓名、性别、身份证号、出生日期、地址信息、有效起始时间、签发机关，同时可输出身份证区域位置和人脸位置信息。以下的是身份校验接口是基于阿里云的身份接口来开发的。

功能描述 身份证识别可以识别二代身份证关键字段内容，关键字段包括：姓名、性别、民族、身份证号、出生日期、地址信息、有效起始时间、签发机关，同时可输出身份证区域位置和人脸位置信息。 应用场景 远程注册：识别用户提交的身份证内容，自动完成用户身份信息填充。 接入指引
操作步骤
1. 注册阿里云账号：打开阿里云官网，在阿里云官网右上角，单击立即注册，按照操作提示完成账号注册。
2. 开通能力：请确保您已开通文字识别服务，若未开通服务请立即开通。
3. 创建AccessKey：请确保您已创建AccessKey，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见RAM授权。
4. 在线调试（可选）：您可以通过OpenAPI Explorer在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。
5. 开发接入步骤： 在SDK总览中选择您要接入使用的SDK语言。 在对应语言的SDK文档中找到AI类目为文字识别（ocr）的SDK包进行安装。 参考文档中提供的示例代码进行适当修改后调用。
6. 示例代码：该能力常用语言的示例代码，请参见身份证识别示例代码。
7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。

Web前端直接调用 小程序场景下直接调用 Android端直接调用 iOS端直接调用 输入限制 图像格式：JPEG、JPG、PNG、BMP、GIF。 图像大小：不超过3 MB。 图像分辨率：大于15×15像素，小于4096×4096像素。 URL地址中不能包含中文字符。  

请求示例

http(s)://ocr.cn-shanghai.aliyuncs.com/?Action=RecognizeIdentityCard      //更多关于访问域名（Endpoint）信息，请参见：https://help.aliyun.com/document_detail/143103.html
&ImageURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/ocr/RecognizeIdentityCard/sfz1.jpg
&Side=face
&公共请求参数

正常返回示例 
XML格式

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

<RecognizeIdentityCardResponse>
    <RequestId>A6175A03-624C-1976-908D-C8BE4C547C45</RequestId>
    <Data>
        <FrontResult>
            <Address>江苏省南京市浦口区天天小区1栋11号</Address>
            <FaceRectVertices>
                <X>569</X>
                <Y>105</Y>
            </FaceRectVertices>
            <FaceRectVertices>
                <X>766</X>
                <Y>104</Y>
            </FaceRectVertices>
            <FaceRectVertices>
                <X>766</X>
                <Y>348</Y>
            </FaceRectVertices>
            <FaceRectVertices>
                <X>569</X>
                <Y>348</Y>
            </FaceRectVertices>
            <FaceRectangle>
                <Center>
                    <X>667</X>
                    <Y>225</Y>
                </Center>
                <Angle>0</Angle>
                <Size>
                    <Height>243</Height>
                    <Width>196</Width>
                </Size>
            </FaceRectangle>
            <CardAreas>
                <X>132</X>
                <Y>485</Y>
            </CardAreas>
            <CardAreas>
                <X>132</X>
                <Y>47</Y>
            </CardAreas>
            <CardAreas>
                <X>817</X>
                <Y>47</Y>
            </CardAreas>
            <CardAreas>
                <X>818</X>
                <Y>482</Y>
            </CardAreas>
            <Gender>男</Gender>
            <Nationality>汉</Nationality>
            <BirthDate>19880722</BirthDate>
            <Name>小明</Name>
            <IDNumber>320001198807220000</IDNumber>
        </FrontResult>
    </Data>
</RecognizeIdentityCardResponse>

JSON格式
 

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

{
  "RequestId" : "A6175A03-624C-1976-908D-C8BE4C547C45",
  "Data" : {
    "FrontResult" : {
      "Address" : "江苏省南京市浦口区天天小区1栋11号",
      "FaceRectVertices" : [ {
        "X" : 569,
        "Y" : 105
      }, {
        "X" : 766,
        "Y" : 104
      }, {
        "X" : 766,
        "Y" : 348
      }, {
        "X" : 569,
        "Y" : 348
      } ],
      "FaceRectangle" : {
        "Center" : {
          "X" : [ 667 ],
          "Y" : [ 225 ]
        },
        "Angle" : 0,
        "Size" : {
          "Height" : [ 243 ],
          "Width" : [ 196 ]
        }
      },
      "CardAreas" : [ {
        "X" : 132,
        "Y" : 485
      }, {
        "X" : 132,
        "Y" : 47
      }, {
        "X" : 817,
        "Y" : 47
      }, {
        "X" : 818,
        "Y" : 482
      } ],
      "Gender" : "男",
      "Nationality" : "汉",
      "BirthDate" : "19880722",
      "Name" : "小明",
      "IDNumber" : "320001198807220000"
    }
  }
}