百度接口实现身份证照片识别

首先这里要简单的感谢一下百度提供的身份证照片识别接口,主要是每天免费的500次。毕竟小公司,能白嫖就白嫖。
今天因为正好用到了,虽然比较简单,但是还是整理一下以便复用。
先贴一下百度的接口文档地址:https://cloud.baidu.com/doc/OCR/s/rk3h7xzck

其实这个真的比较简单,申请key和秘钥就不说了,直接从使用开始。
首先从鉴权开始说,这个token的有效期是30天,但是保险起见,我这边的处理办法是存到redis中,有效期的20天。然后在每次取的时候判断是不是过期了,如果是则重新set进去。除了这个没啥好说的了,直接贴代码:

获取token

import org.json.JSONObject;

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.util.List;
import java.util.Map;

public class BaiduUtil {

    public static String getAuth() {
        // 官网获取的 API Key 更新为你注册的
        String clientId = "XXXX";
        // 官网获取的 Secret Key 更新为你注册的
        String clientSecret = "XXXX";
        return getAuth(clientId, clientSecret);
    }

    /**
     * 获取API访问token
     * 该token有一定的有效期,需要自行管理,当失效时需重新获取.
     * @param ak - 百度云官网获取的 API Key
     * @param sk - 百度云官网获取的 Securet Key
     * @return assess_token 示例:
     * "24.460da4889caad24cccdb1fea17221975.2592000.1491995545.282335-1234567"
     */
    public static String getAuth(String ak, String sk) {
        // 获取token地址
        String authHost = "https://aip.baidubce.com/oauth/2.0/token?";
        String getAccessTokenUrl = authHost
                // 1. grant_type为固定参数
                + "grant_type=client_credentials"
                // 2. 官网获取的 API Key
                + "&client_id=" + ak
                // 3. 官网获取的 Secret Key
                + "&client_secret=" + sk;
        try {
            URL realUrl = new URL(getAccessTokenUrl);
            // 打开和URL之间的连接
            HttpURLConnection connection = (HttpURLConnection) realUrl.openConnection();
            connection.setRequestMethod("GET");
            connection.connect();
            // 获取所有响应头字段
            Map<String, List<String>> map = connection.getHeaderFields();
            // 遍历所有的响应头字段
            for (String key : map.keySet()) {
                System.err.println(key + "--->" + map.get(key));
            }
            // 定义 BufferedReader输入流来读取URL的响应
            BufferedReader in = new BufferedReader(new InputStreamReader(connection.getInputStream()));
            String result = "";
            String line;
            while ((line = in.readLine()) != null) {
                result += line;
            }
            /**
             * 返回结果示例
             */
            System.err.println("result:" + result);
            JSONObject jsonObject = new JSONObject(result);
            String access_token = jsonObject.getString("access_token");
            return access_token;
        } catch (Exception e) {
            System.err.printf("获取token失败!");
            e.printStackTrace(System.err);
        }
        return null;
    }
}

上面的是获取token的代码。除了需要自己填入API key和秘钥就没啥改动了。引入的依赖我也顺便贴上了。和官网的差不多,这个就这样。

发送Post请求的HttpUtil

/**
 * http 工具类
 */
public class HttpUtil {

    public static String post(String requestUrl, String accessToken, String params)
            throws Exception {
        String contentType = "application/x-www-form-urlencoded";
        return HttpUtil.post(requestUrl, accessToken, contentType, params);
    }

    public static String post(String requestUrl, String accessToken, String contentType, String params)
            throws Exception {
        String encoding = "UTF-8";
        if (requestUrl.contains("nlp")) {
            encoding = "GBK";
        }
        return HttpUtil.post(requestUrl, accessToken, contentType, params, encoding);
    }

    public static String post(String requestUrl, String accessToken, String contentType, String params, String encoding)
            throws Exception {
        String url = requestUrl + "?access_token=" + accessToken;
        return HttpUtil.postGeneralUrl(url, contentType, params, encoding);
    }

    public static String postGeneralUrl(String generalUrl, String contentType, String params, String encoding)
            throws Exception {
        URL url = new URL(generalUrl);
        // 打开和URL之间的连接
        HttpURLConnection connection = (HttpURLConnection) url.openConnection();
        connection.setRequestMethod("POST");
        // 设置通用的请求属性
        connection.setRequestProperty("Content-Type", contentType);
        connection.setRequestProperty("Connection", "Keep-Alive");
        connection.setUseCaches(false);
        connection.setDoOutput(true);
        connection.setDoInput(true);

        // 得到请求的输出流对象
        DataOutputStream out = new DataOutputStream(connection.getOutputStream());
        out.write(params.getBytes(encoding));
        out.flush();
        out.close();

        // 建立实际的连接
        connection.connect();
        // 获取所有响应头字段
        Map<String, List<String>> headers = connection.getHeaderFields();
        // 遍历所有的响应头字段
        for (String key : headers.keySet()) {
            System.err.println(key + "--->" + headers.get(key));
        }
        // 定义 BufferedReader输入流来读取URL的响应
        BufferedReader in = null;
        in = new BufferedReader(
                new InputStreamReader(connection.getInputStream(), encoding));
        String result = "";
        String getLine;
        while ((getLine = in.readLine()) != null) {
            result += getLine;
        }
        in.close();
        System.err.println("result:" + result);
        return result;
    }
}

这个也是官网上用到的工具类,而且特别贴心的给了下载地址,我这里就是简单的搬运了一下。

实现身份证校验

这个稍微有一点点逻辑,比如说身份证正反面,还有就是我说的获取token的方法啥的,但是都比较简单,我先贴出来:

    @Override
    public R cardAuto(String imgs,String type) {
        //// 从redis中获取信息,redis保存时间是20天。
        String accessToken = stringRedisTemplate.opsForValue().get("bd_access_token");
        if(accessToken  == null || "".equals(accessToken)){//token过期则从新set进去,并且获取
            stringRedisTemplate.opsForValue().set("bd_access_token", BaiduUtil.getAuth(), 20l,TimeUnit.DAYS);
            accessToken = stringRedisTemplate.opsForValue().get("bd_access_token");
        }
        // 请求url
        String url = "https://aip.baidubce.com/rest/2.0/ocr/v1/idcard";
        try {
            String imgParam = URLEncoder.encode(imgs, "UTF-8");
            String param = "id_card_side=" + type + "&image=" + imgParam;
            if(type.equals("front")) param = param+"&detect_photo=true";
            String result = HttpUtil.post(url, accessToken, param);
            System.out.println(result);
            return R.ok().put("data",result);
        } catch (Exception e) {
            e.printStackTrace();
        }
        return R.error();
    }

这个就是一个实现类,其中type是分为(front/back)。也就是身份证正面和反面。然后imgs直接接收的就是图片的base64编码,所以相对于官网稍微简单了点。另外如果是身份证正面我这里还要了下人像的图片。
反正到这里就可以根据需求自己改动了。至此,对接百度的身份证识别就完成啦!
而且假如出错这个错误原因也描述的比较清楚,总体来说通俗易懂好对接,第一次对接百度的除了地图的api,感觉还是非常不错的。

本片笔记就记到这里,如果稍微帮到你了记得点个喜欢点个关注,也祝大家工作顺顺利利!提前拜个早年吧~

推荐阅读更多精彩内容