700      阿里云

身份证识别__API介绍_文字识别_人工智能图像类-阿里云

本页面主要介绍服务对应的接口和返回结果中的关键字段的含义，请在阅读本页面之前，了解请求数据格式介绍，了解输入输出的通用数据格式。 此外，在本页最后，附上了身份证服务调用的程序示例，以供参考。

请求接口

• 云市场接口

  • 请求方法: POST
  • 请求url: 在云市场搜索印刷文字识别-身份证识别,在API接口中找到调用地址

• 数加接口

  • 请求方法： POST
  • 请求url: 打开管理控制台，接口名称选择ocr_idcard,查看请求地址

请求参数

configure 参数的具体字段如下：

请求参数的POST请求body如下：

{
    "inputs": [
    {
        "image": {
            "dataType": 50,                         #50表示image的数据类型为字符串
            "dataValue": "base64_image_string"      #图片以base64编码的string
        },
        "configure": {
            "dataType": 50,
            "dataValue": "{
                "side": "face"                      #身份证正反面类型: face/back
            }"
        }
    }]
}

返回结果格式

返回结果分为正面和反面两种格式，正面返回结果格式如下：

{
    "outputs": [
    {
        "outputLabel": "ocr_id",
        "outputMulti": {},
        "outputValue": {
            "dataType": 50,
            "dataValue": "{
                "address"    : "浙江省杭州市余杭区文一西路969号",   #地址信息
                "config_str" : "{\"side\":\"face\"}",                #配置信息，同输入configure
                "name" : "张三",                                  #姓名
                "num" : "1234567890",                             #身份证号
                "sex" : "男",                                     #性别
                "birth" : "20000101",                             #出生日期
                "nationality" : "汉",                             #民族
                "success" : true                                  #识别结果，true表示成功，false表示失败
            }"
        }
    }]
}

每一个请求返回的结果都是一个json字符串，由dataValue关键词可以索引到，主要有7个字段：

• address： 识别的地址信息， 类型为字符串
• config_str： 表示发送请求时候的配置字符串，为json字符串格式，表示输入时候的配置参数， 类型为字符串
• name： 识别的身份证姓名， 类型为字符串
• num： 识别的身份证号码， 类型为字符串
• sex： 识别的性别， 类型为字符串
• birth： 识别的出生日期， 类型为字符串
• nationality : 识别的民族， 类型为字符串
• success： 识别流程是否出现异常， false表示识别失败，true表示识别成功， 类型为布尔型

反面输出结果格式如下：

{
    "outputs": [
    {
        "outputLabel": "ocr_id",
        "outputMulti": {},
        "outputValue": {
            "dataType": 50,
            "dataValue": "{
                "config_str" : 
                "{\"side\":\"back\"}",#配置信息，同输入configure
                "start_date" : "19700101",       #有效期起始时间
                "end_date" : "19800101",         #有效期结束时间
                "issue" : "杭州市公安局",         #签发机关
                "success" : true                   #识别结果，true表示成功，false表示失败
            }"
        }
    }]
}

每个返回结果同样存储在以dataValue为关键词所对应的键值对中，其中有5个字段：

• config_str: 和正面字段含义一样， 类型为字符串
• issue: 身份证签发机关，类型为字符串
• start_date: 身份证有效期起始时间，类型为字符串
• end_date: 身份证有效期结束时间，类型为字符串
• success: 识别流程是否成功，类型为布尔型

程序示例

云市场

在云市场搜索印刷文字识别-身份证识别,在API接口中找到请求示例

数加平台

import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import org.apache.commons.codec.binary.Base64;
import org.json.JSONObject;
import org.json.JSONArray;
import org.json.JSONException;
public class IDcard {
    /*
     * 获取参数的json对象
     */
    public static JSONObject getParam(int type, JSONObject dataValue) {
        JSONObject obj = new JSONObject();
        try {
            obj.put("dataType", type);
            obj.put("dataValue", dataValue);
        } catch (JSONException e) {
            e.printStackTrace();
        }
        return obj;
    }
    /*
     * 获取参数的json对象
     */
    public static JSONObject getParam(int type, String dataValue) {
        JSONObject obj = new JSONObject();
        try {
            obj.put("dataType", type);
            obj.put("dataValue", dataValue);
        } catch (JSONException e) {
            e.printStackTrace();
        }
        return obj;
    }
    public static void main(String[] args) {
        String imgFile = "idcard.jpg";
        String serviceURL = "your-service-url";
        String akID = "your access key id";
        String akSecret = "your access key secret";
        // 对图像进行base64编码
        String imgBase64 = "";
        try {
            File file = new File(imgFile);
            byte[] content = new byte[(int) file.length()];
            FileInputStream finputstream = new FileInputStream(file);
            finputstream.read(content);
            finputstream.close();
            imgBase64 = new String(Base64.encodeBase64(content));
        } catch (IOException e) {
            e.printStackTrace();
            return;
        }
        // 拼装请求body的json字符串
        JSONObject requestObj = new JSONObject();
        try {
            JSONObject configObj = new JSONObject();
            JSONObject obj = new JSONObject();
            JSONArray inputArray = new JSONArray();
            configObj.put("side", configStr);
            obj.put("image", getParam(50, imgBase64));
            obj.put("configure", getParam(50, configObj.toString()));
            inputArray.put(obj);
            requestObj.put("inputs", inputArray);
        } catch (JSONException e) {
            e.printStackTrace();
        }
        String body = requestObj.toString();
        //Sender代码参考 https://help.aliyun.com/document_detail/shujia/OCR/ocr-api/sender.html
        String result = Sender.sendPost(serviceURL, body, akID, akSecret);
        System.out.println(result);
        // 解析请求结果
        try {
            JSONObject resultObj = new JSONObject(result);
            JSONArray outputArray = resultObj.getJSONArray("outputs");
            String output = outputArray.getJSONObject(0).getJSONObject("outputValue").getString("dataValue"); // 取出结果json字符串
            JSONObject out = new JSONObject(output);
            if (out.getBoolean("success")) {
                String addr = out.getString("address"); // 获取地址
                String name = out.getString("name"); // 获取名字
                String num = out.getString("num"); // 获取身份证号
                System.out.printf(" name : %s n num : %sn address : %sn", name, num, addr);
            } else {
                System.out.println("predict error");
            }
        } catch (JSONException e) {
            e.printStackTrace();
        }
        }
}