外国人永久居住证识别(含质检)

接口描述

用户通过发送HTTP Post请求方式提交数据至公有云服务器，服务器识别并返回json格式的识别结果。

接口说明

请求URL：http://api.exocr.com/ocr/v1/foreigner_greencard_check

请求方式：HTTP Post

返回格式：json

Header

请求参数

返回结果

调用示例

java(相关依赖库下载)

package com.exocr.httpclient;



import java.io.File;

import java.io.FileInputStream;

import java.io.FileNotFoundException;

import java.io.IOException;

import java.io.InputStream;

import java.util.HashMap;

import java.util.Map;



import com.exocr.common.utils.HttpClientUtils;



public class Test {



   public static void main(String[] args) throws FileNotFoundException {

      /**

       * base64

       */

      //识别url

      String url = " http://api.exocr.com/ocr/v1/foreigner_greencard_check";

      //设置请求参数

      Map<String, String> params = new HashMap<String, String>();

      params.put("app_key", "#####");

      params.put("app_secret", "#####");

      //设置识别图像base64编码

      params.put("image_base64", "base64ImageStr");

      //发送请求，得到识别结果

      String result = HttpClientUtils.doPost(url, params);

      System.out.println(result);

      /**

       * url

       */

      //设置请求参数、识别图像url

      params.put("app_key", "#####");

      params.put("app_secret", "#####");

      params.put("image_url", "imageUrl");

      //发送请求，得到识别结果

      result = HttpClientUtils.doPost(url, params);

      System.out.println(result);

      /**

       * 二进制

       */

      //设置请求参数

      params.put("app_key", "#####");

      params.put("app_secret", "#####");

      //拿到本地图像，写入数据流

      File file = new File("/Users/mac/logs/test.png");

      InputStream in = new FileInputStream(file);

      //设置数据流

      Map<String, InputStream> streamMap = new HashMap<String, InputStream>();

      streamMap.put("image_binary", in);

      //发送请求，得到识别结果

      result = HttpClientUtils.doPostStream(url, params, streamMap);

      //关闭io流

      try {

         in.close();

      } catch (IOException e) {

         e.printStackTrace();

      }

      System.out.println(result);

   }

}

返回结果示例

{
    "error_code": 0,
    "description": "识别成功",
    "result": {
        "recognize_result": {
            "gender": {
                "words": "男/M",
                "score": 0.99892,
                "position": {
                    "left": 83,
                    "top": 186,
                    "width": 76,
                    "height": 29
                },
                "quad": "83,186,159,186,159,215,83,215",
                "chinese_key": "性别"
            },
            "idno": {... },
            "issued": {...},
            "name": {...},
            "english_name": {...},
            "valid": {...},
            "birth_date": {...},
            "nationality": {...}
        },
        "check_result": [
            {
                "risk": 6,
                "risk_list": [
                    6
                ],
                "risk_details": {
                    "edge_cover": {
                        "bboxes": [],
                        "classes": [],
                        "scores": [],
                        "class_names": []
                    },
                    "blur_score": 0.004929025191813707
                },
                "quad": [30,10,1093,10,1093,692,30,692]
            }
        ]
    },
    "request_id": "bc9a9c889b2a11eea6ba047c16805d78",
    "recognize_time": 1579,
    "dbg_xml": "",
    "rotation": 0,
    "template_name": "外国人永久居留身份证人像面2017",
    "face_img": ""
}