关于快递查询接口的实现

昨天做的公司项目需要用到快递查询的接口，我在网上找了挺多的资料，后来自己整理了一下，具体的实现步骤如下（我使用的是聚合科技的快递接口）：

1.先在聚合科技注册一个账号，然后免费申请使用这个接口，就可以得到一个分配给你的key

2.点击个人中心->数据中心->我的接口->接口，就可以查看API文档、实例代码。

3.点击个人中心->数据中心->我的接口->测试，在提示的地方输入真实正确的库快递信息就可以查到物流信息。

4.查询成功后可以在该页面的请求详情中看到自己的key：

5.最后是根据给出的实例代码就可以在项目中使用了。

这是我自己整合的一些重要参数：

名称	类型	必填	说明
com	String	是	需要查询的快递公司编号
no	String	是	需要查询的订单号
key	String	是	应用APPKEY(应用详细页查询)
dtype	String	否	返回数据的格式,xml或json，默认json
SenderPhone	Int	否	发件人的手机后四位（顺丰快递查询时要提供发件人或者收件人的其中一个）
ReceiverPhone	Int	否	收件人的手机号码后四位（顺丰快递查询时要提供发件人或者收件人的其中一个）
接口地址	Url	是	http://v.juhe.cn/exp/index
请求方式			Get/post
支持格式			Json/xml

还有一些快递公司的编号：

快递公司	快递公司编号
顺丰	sf
申通	sto
圆通	yt
汇通	ht
中通	zto
EMS	ems
韵达	yd

实例代码如下：

（使用 net.sf.json.JSONObject包是需要导入一些jar包，不然会报错，这个在百度上搜索会有一大堆的，就不放上来了。）

import java.io.BufferedReader;
import java.io.DataOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.UnsupportedEncodingException;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLEncoder;
import java.util.HashMap;
import java.util.Map;
 
import net.sf.json.JSONObject;

public class Test {


	 
	/**
	*常用快递调用示例代码 － 聚合数据
	*在线接口文档：http://www.juhe.cn/docs/43
	**/
	 
	    public static final String DEF_CHATSET = "UTF-8";
	    public static final int DEF_CONN_TIMEOUT = 30000;
	    public static final int DEF_READ_TIMEOUT = 30000;
	    public static String userAgent =  "Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/29.0.1547.66 Safari/537.36";
	 
	    //配置您申请的KEY
	    public static final String APPKEY ="你申请的key";
	 
	    //1.常用快递查询API
	    public static void getRequest1(){
	        String result =null;
	        String url ="http://v.juhe.cn/exp/index";//请求接口地址
	        Map params = new HashMap();//请求参数
	            params.put("com","快递公司编号");//需要查询的快递公司编号
	            params.put("no","订单号");//需要查询的订单号
	            params.put("key",APPKEY);//应用APPKEY(应用详细页查询)
	            params.put("dtype","json");//返回数据的格式,xml或json，默认json
	 
	        try {
	            result =net(url, params, "GET");
	            JSONObject object = JSONObject.fromObject(result);
	            if(object.getInt("error_code")==0){
	                System.out.println(object.get("result"));
	            }else{
	                System.out.println(object.get("error_code")+":"+object.get("reason"));
	            }
	        } catch (Exception e) {
	            e.printStackTrace();
	        }
	    }
	 
	    //2.快递公司编号对照表
	    public static void getRequest2(){
	        String result =null;
	        String url ="http://v.juhe.cn/exp/com";//请求接口地址
	        Map params = new HashMap();//请求参数
	 
	        try {
	            result =net(url, params, "GET");
	            JSONObject object = JSONObject.fromObject(result);
	            if(object.getInt("error_code")==0){
	                System.out.println(object.get("result"));
	            }else{
	                System.out.println(object.get("error_code")+":"+object.get("reason"));
	            }
	        } catch (Exception e) {
	            e.printStackTrace();
	        }
	    }
	 
	 
	 
	    public static void main(String[] args) {
	    	(new Test()).getRequest1();
	    	(new Test()).getRequest2();
	    }
	 
	    /**
	     *
	     * @param strUrl 请求地址
	     * @param params 请求参数
	     * @param method 请求方法
	     * @return  网络请求字符串
	     * @throws Exception
	     */
	    public static String net(String strUrl, Map params,String method) throws Exception {
	        HttpURLConnection conn = null;
	        BufferedReader reader = null;
	        String rs = null;
	        try {
	            StringBuffer sb = new StringBuffer();
	            if(method==null || method.equals("GET")){
	                strUrl = strUrl+"?"+urlencode(params);
	            }
	            URL url = new URL(strUrl);
	            conn = (HttpURLConnection) url.openConnection();
	            if(method==null || method.equals("GET")){
	                conn.setRequestMethod("GET");
	            }else{
	                conn.setRequestMethod("POST");
	                conn.setDoOutput(true);
	            }
	            conn.setRequestProperty("User-agent", userAgent);
	            conn.setUseCaches(false);
	            conn.setConnectTimeout(DEF_CONN_TIMEOUT);
	            conn.setReadTimeout(DEF_READ_TIMEOUT);
	            conn.setInstanceFollowRedirects(false);
	            conn.connect();
	            if (params!= null && method.equals("POST")) {
	                try {
	                    DataOutputStream out = new DataOutputStream(conn.getOutputStream());
	                        out.writeBytes(urlencode(params));
	                } catch (Exception e) {
	                    // TODO: handle exception
	                }
	            }
	            InputStream is = conn.getInputStream();
	            reader = new BufferedReader(new InputStreamReader(is, DEF_CHATSET));
	            String strRead = null;
	            while ((strRead = reader.readLine()) != null) {
	                sb.append(strRead);
	            }
	            rs = sb.toString();
	        } catch (IOException e) {
	            e.printStackTrace();
	        } finally {
	            if (reader != null) {
	                reader.close();
	            }
	            if (conn != null) {
	                conn.disconnect();
	            }
	        }
	        return rs;
	    }
	 
	    //将map型转为请求参数型
	    public static String urlencode(Map<String,Object>data) {
	        StringBuilder sb = new StringBuilder();
	        for (Map.Entry i : data.entrySet()) {
	            try {
	                sb.append(i.getKey()).append("=").append(URLEncoder.encode(i.getValue()+"","UTF-8")).append("&");
	            } catch (UnsupportedEncodingException e) {
	                e.printStackTrace();
	            }
	        }
	        return sb.toString();
	    }
	
}