首页 > 编程语言> > java 调用腾讯身份OCR接口文档实例（绝对可用）

java 调用腾讯身份OCR接口文档实例（绝对可用）

2019-09-02 21:01:42 作者：互联网

1.情景展示

　　通过读取身份证照片上的信息，实现自动填充功能。

2.原因分析

　　想要解析照片上所携带的相关信息，就需要识别照片的功能，腾讯提供了免费的身份证OCR接口，可供大家使用。

　　没有耐心的可以直接看接口调用(跳过接口规则介绍)

3.接口规则

　　接口地址：https://api.ai.qq.com/fcgi-bin/ocr/ocr_idcardocr

　　API地址：https://ai.qq.com/doc/ocridcardocr.shtml

　　规则

　　注意：

　　1.调取接口的请求方式必须使用form表单提交，JSON请求调取接口无效（我已经试过）；

　　2.返回的是JSON格式的字符串，解析具体数据时，并不能直接当做json对象取值，需要先将其转换成JSON对象。

　　入参介绍

　　app_id，注册账号后自动生成的唯一标识，配合密钥，才能拥有调取接口的权限；

　　time_stamp，时间戳，获取系统当前时间戳（单位是秒，不是毫秒），用于超时校验的（5分钟）；

　　nonce_str，随机字符串，最大长度为32位，我们直接生成32位即可。

　　sign，用于安全校验，主要是防止数据在传输过程中被篡改的；

　　image，由图片转换成base64码，只支持jpg,png和bmp格式的图片并且图片大小不能够超过1MB。

　　另外，不能包含图片类型的声明，即：需要将头部的，"data:image/jpeg;base64,"，"data:image/png;base64,"，"data:image/bmp;base64,"去掉。

　　card_type，就很简单了，如果是正面用0，反面用1。

　　需要说明的是：app_id，time_stamp和card_type这三个字段的值实际上是字符串，不用理会对于整数的说明，本身它对值的类型根本就限制不住，因为它要求的是必须是form表单提交，form表单提交的数据类型，永远只有一种，那就是字符串，这一点他们是自相矛盾的！

　　sign的生成规则如下：

　　意思是说：将这几个必要参数，排除sign后，按照字典升序排列（ASCII升序排列），组成get请求url参数拼接的形式，

　　1.必要参数的升序拼接结果：app_id=value1&card_type=value2&image=value3&nonce_str=value4&sign=value5&time_stamp=value6

　　2.image的值，即base64格式的数据需要使用URL进行编码，其余字段的值不需要使用URL编码。

　　3.生成未加密前的字符串：将第一步的结果在其末尾拼接上密钥，即：app_id=value1&card_type=value2&image=value3&nonce_str=value4&sign=value5&time_stamp=value6&app_key=value7

　　4.生成sign：对第三步的结果，使用MD5加密，加密结果转大写，得到sign的值。

　　返回数据

　　并发量限制（QPS-每秒可调用请求的次数）

4.具体调用

　　前提：假设前端给我们传过来的是一个base64格式的图片。

　　设置好常量

// 接口分配的ID
private final static int TX_APP_ID = 1111111111;
// 接口对应的密钥
private final static String TX_APP_KEY = "2222222222222222";
// 接口调取地址
private final static String TX_ORCURL = "https://api.ai.qq.com/fcgi-bin/ocr/ocr_idcardocr";

　　导入

import java.util.Map;
import java.util.TreeMap;
import java.util.UUID;

　　具体代码

String imgBase64 = request.getParameter("imgBase64");
if (imgBase64.startsWith("data:image/jpeg;base64,")) {
    imgBase64 = imgBase64.replace("data:image/jpeg;base64,", "");
} else if (imgBase64.startsWith("data:image/png;base64,")) {
    imgBase64 = imgBase64.replace("data:image/png;base64,", "");
} else if (imgBase64.startsWith("data:image/bmp;base64,")) {
    imgBase64 = imgBase64.replace("data:image/bmp;base64,", "");
}

// 时间戳
int time_stamp = (int) (System.currentTimeMillis()/1000);
// 随机字符串
String nonce_str = UUID.randomUUID().toString().replace("-", "");
// 鉴权
String sign = "";
// String image = URLEncoder.encode(imgBase64, "UTF-8");
// base64图片
String image = imgBase64;
// 身份证正反面（0-正面；1-反面）
int card_type = 0;
// 必须使用TreeMap（会自动生成有序Map）
Map<String, String> sortedMap = new TreeMap<>();
sortedMap.put("app_id", String.valueOf(TX_APP_ID));
sortedMap.put("time_stamp", String.valueOf(time_stamp));
sortedMap.put("nonce_str", nonce_str);
sortedMap.put("image", image);
sortedMap.put("card_type", String.valueOf(card_type));
// 生成鉴权
sign = generateSign(sortedMap);
sortedMap.put("sign", sign);
// 调取腾讯接口
String resultData = httpPostWithForm(TX_ORCURL,sortedMap);
// TODO 对resultData进行进一步处理（可直接返给前端处理）

　　生成鉴权代码

　　需导入

import java.io.UnsupportedEncodingException;
import java.net.URLEncoder;
import java.util.Iterator;
import java.util.Map;
import org.apache.commons.codec.digest.DigestUtils;

/**
 * 生成腾讯身份证OCR鉴权
 * @explain key1=value1&key2=value2&...
 * @param sortedMap	key按照字典进行升序排列的Map
 * @return	sign（MD5加密并转大写）
 */
private static String generateSign(Map<String, String> sortedMap) {
    // 鉴权
    String sign = "";
    Iterator<String> iter = sortedMap.keySet().iterator();
    StringBuilder sb = new StringBuilder();
    while(iter.hasNext()){ 
        String key =iter.next(); 
        Object value = sortedMap.get(key);
        // base64需要使用URL进行编码
        if (key.equals("image")) {
            try {
                value = URLEncoder.encode(sortedMap.get(key), "UTF-8");
            } catch (UnsupportedEncodingException e) {
                e.printStackTrace();
            }
        }
        sb.append(key).append("=").append(value).append("&");
    }  
    sb.append("app_key").append("=").append(TX_APP_KEY);
    // 加密前
    sign = sb.toString();
    // 加密后（MD5加密并转大写）
    sign = DigestUtils.md5Hex(sign).toUpperCase();
    return sign;
}

　　发送post请求代码

　　需导入

import java.util.ArrayList;
import java.util.List;
import java.util.Map;
import org.apache.commons.httpclient.HttpStatus;
import org.apache.http.HttpResponse;
import org.apache.http.client.entity.UrlEncodedFormEntity;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClientBuilder;
import org.apache.http.message.BasicNameValuePair;
import org.apache.http.util.EntityUtils;

/**
 * 以form表单形式提交数据，发送post请求
 * @explain 
 *   1.请求头：httppost.setHeader("Content-Type","application/x-www-form-urlencoded")
 *   2.提交的数据格式：key1=value1&key2=value2...
 * @param url 请求地址
 * @param paramsMap 具体数据
 * @return 服务器返回数据
 */
public static String httpPostWithForm(String url,Map<String, String> paramsMap){
    // 用于接收返回的结果
    String resultData ="";
     try {
            HttpPost post = new HttpPost(url);
            List<BasicNameValuePair> pairList = new ArrayList<BasicNameValuePair>();
            // 迭代Map-->取出key,value放到BasicNameValuePair对象中-->添加到list中
            for (String key : paramsMap.keySet()) {
                pairList.add(new BasicNameValuePair(key, paramsMap.get(key)));
            }
            UrlEncodedFormEntity uefe = new UrlEncodedFormEntity(pairList, "utf-8");
            post.setEntity(uefe); 
            // 创建一个http客户端
            CloseableHttpClient httpClient = HttpClientBuilder.create().build();
            // 发送post请求
            HttpResponse response = httpClient.execute(post);
            
            // 状态码为：200
            if(response.getStatusLine().getStatusCode() == HttpStatus.SC_OK){
                // 返回数据：
                resultData = EntityUtils.toString(response.getEntity(),"UTF-8");
            }else{
                throw new RuntimeException("接口连接失败！");
            }
        } catch (Exception e) {
            throw new RuntimeException("接口连接失败！");
        }
     return resultData;
}

写在最后