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();
        }
        }
}