国际快递查询接口JAVA示例-trackingmore

国际快递查询接口

国际快递查询接口的需求量很大，例如一些跨境电商B2C网站、快递查询APP、快递柜、跨境物流公司等都会需要用到国际快递接口。

目前市面上的快递接口，以国内快递居多，有些虽然号称支持多家国际快递和国际邮政，但实际调用时，由于国际快递网站变化较多，所以经常出现不稳定的情况。这里我要介绍的是trackingmore的国际快递接口，他们一直专做国际快递，支持的380家快递也绝大部分是国外的邮政与快递公司，所以提供的接口也非常可靠。

国际快递特性（含国际邮政）

1.可在两个网站查询到信息：属于万国邮联的国际邮政单号，可以分别在发件国家邮政官网与目的国家邮政官网查询到数据。相对而言，国内快递一般只需要在一个网站查询数据。

2.海关问题：国际包裹是跨国包裹，需要通过两国的海关查验，有时候会被海关扣押，进而导致时效不如国内快递稳定。

3.运输时间长：国际邮政包裹相对国际快递价格便宜很多，所以运输时间也慢，甚至会需要1到2个月才能签收。

4.多语言问题：由于包裹是跨国的，必然会涉及多语言问题，国内客户需要看到的是中文信息，而国外客户希望看到的是当地语言的物流信息。

国际快递API特性（trackingmore）

1.包含发件国与目的国的数据：Trackingmore的API中包含的参数有 origin_info（发件国物流信息）和destination_info（目的国物流信息），所以通过该接口可以让用户看到最为完整的物信息。

2.智能识别快递状态：当检测到包裹在海关停滞，或者包裹被退回等信息，Trackingmore会返回“exception”（可能异常）的状态，帮助用户第一时间发现异常件，从而尽早处理。

3.按照单号个数计费：由于国际包裹的运输时间很长，完整的运输周期可能需要两个月，而每天至少需要查询两次以上。所以按照查询单号个数计费而不是按照API调用次数计费，是最为良心的计费方式。

4.多语言API：针对不同的快递商，可以按照语言返回不同的结果。包含中文、英文、日语、印度语、阿拉伯语等等。

对接示例

这里以Trackingmore为例，不同的接口的对接方式比较类似，都需要注册，并生成自己的API key。以下以Trackingmore的实时查询API为例。

　　接口支持的消息接收方式为HTTP POST

　　请求方法的编码格式为 utf-8

　　请求body部分的参数的数据格式为json 格式

接口参数

接口请求地址

http://api.trackingmore.com/v2/trackings/realtime

请求头部信息参数

参数名称	类型	说明	是否必须
Content-Type:	application/json	定义请求头部的数据格式	是
Trackingmore-Api-Key:	string	Trackingmore 后台获取的API	是

请求body参数说明

参数说明	类型	说明	是否必须
tracking_number	string	查询快递的快递单号	是
carrier_code	string	trackingmore定义的快递商简码，比如china ems 就是china-ema	是

carrier_code 参数是trackingmore 自己定义的快递商家的简码，具体的可以在这里查看。

还有需要注意的就是body部分这两个参数需要时json数据格式。大概样子就是这样的

1 {
2     "tracking_number": "LK664578623CN",
3     "carrier_code": "china-ems"
4 }

返回参数定义

参数名称	参数类型	参数说明	是否一定要返回该项值
code	数字	返回码	成功返回200，失败有其他队列的错误码
type	string	接口类型	成功返回Success
message	string	返回信息说明	成功返回Succes,失败返回队列的错误信息
data	json	查询到的物流信息	成功返回物流信息，失败返回空

其他的状态响应简码可以在这里看到。

返回示例

{
    "meta": {
        "code": 200,
        "type": "Success",
        "message": "Success"
    },
    "data": {
        "items": [{
            "id": "442f798ea35749e7605d1a73d4181a01",
            "tracking_number": "RE113184005HK",
            "carrier_code": "hong-kong-post",
            "status": "transit",
            "original_country": "* [CN]",
            "destination_country": "Colombia",
            "itemTimeLength": null,
            "origin_info": {
                "weblink": "http:\/\/www.hongkongpost.hk\/",
                "phone": "852 2921 2222",
                "carrier_code": "hong-kong-post",
                "trackinfo": [{
                    "Details": "CO",
                    "StatusDescription": "The item ( RE113184005HK ) left * for its destination on  10-Oct-2015 ",
                    "Date": "2015-10-09 00:00"
                }]
            },
            "destination_info": {
                "weblink": "http:\/\/www.4-72.com.co\/",
                "phone": "(57-1) 4722000",
                "carrier_code": "colombia-post",
                "trackinfo": [{
                    "Date": "2015-10-22 20:52",
                    "StatusDescription": "DIGITALIZADO",
                    "Details": "CTP.CENTRO A"
                }, {
                    "Date": "2015-10-22 17:02",
                    "StatusDescription": "Registro de entrega exitosa",
                    "Details": ""
                }, {
                    "Date": "2015-10-22 16:55",
                    "StatusDescription": "ENTREGADO",
                    "Details": "CD.MONTEVIDEO"
                }, {
                    "Date": "2015-10-22 09:31",
                    "StatusDescription": "REASIGNADO",
                    "Details": "CD.NORTE"
                }, {
                    "Date": "2015-10-22 08:52",
                    "StatusDescription": "REASIGNADO",
                    "Details": "CD.NORTE"
                }, {
                    "Date": "2015-10-22 02:39",
                    "StatusDescription": "En proceso",
                    "Details": "CTP.CENTRO A"
                }, {
                    "Date": "2015-10-21 16:36",
                    "StatusDescription": "En proceso",
                    "Details": "CTP.CENTRO A"
                }, {
                    "Date": "2015-10-20 06:29",
                    "StatusDescription": "Envío Recibido en la oficina de cambio internacional",
                    "Details": "COBOGC"
                }]
            }
        }]
    }
}

JAVA接口对接示例

String	urlStr =null;
String requestData="{\"tracking_number\": \"RQ958152738CN\",\"carrier_code\":\"china-ems\"}";
String result = new Tracker().orderOnlineByJson(requestData,urlStr,"realtime");

package trackingMore;

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.io.OutputStreamWriter;
import java.net.HttpURLConnection;
import java.net.URL;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

public class Tracker {

	/** Apikey*/
	private String Apikey="Apikey you get from trackingMore";	

	/**
     * Json
     */
	public String orderOnlineByJson(String requestData,String urlStr,String type) throws Exception{
		//---headerParams
		Map headerparams = new HashMap();
		headerparams.put("Trackingmore-Api-Key", Apikey);
		headerparams.put("Content-Type", "application/json");
		//---bodyParams
		List bodyParams = new ArrayList();
		String result =null;
		if(type.equals("post")){
			String ReqURL="http://api.trackingmore.com/v2/trackings/post";
			bodyParams.add(requestData);
			result=sendPost(ReqURL, headerparams , bodyParams,"POST");

		}else if(type.equals("get")){

			String ReqURL="http://api.trackingmore.com/v2/trackings/get";
			String RelUrl = ReqURL+urlStr;
			result=sendPost(RelUrl, headerparams , bodyParams,"GET");

		}else if(type.equals("batch")){

			String ReqURL="http://api.trackingmore.com/v2/trackings/batch";
			bodyParams.add(requestData);
			result=sendPost(ReqURL, headerparams , bodyParams,"POST");

		}else if(type.equals("codeNumberGet")){

			String ReqURL="http://api.trackingmore.com/v2/trackings";
			String RelUrl = ReqURL+urlStr;
			result=sendGet(RelUrl, headerparams,"GET");

		}else if(type.equals("codeNumberPut")){

			String ReqURL="http://api.trackingmore.com/v2/trackings";
			bodyParams.add(requestData);
			String RelUrl = ReqURL+urlStr;
			result=sendPost(RelUrl, headerparams , bodyParams,"PUT");

		}else if(type.equals("codeNumberDelete")){

			String ReqURL="http://api.trackingmore.com/v2/trackings";
			String RelUrl = ReqURL+urlStr;
			result=sendGet(RelUrl, headerparams ,"DELETE");

		}else if(type.equals("realtime")){

			String ReqURL="http://api.trackingmore.com/v2/trackings/realtime";
			bodyParams.add(requestData);
			result=sendPost(ReqURL, headerparams , bodyParams,"POST");

		}

		return result;

	}

	private String sendPost(String url, Map headerParams , List bodyParams,String mothod) {
        OutputStreamWriter out = null;
        BufferedReader in = null;
        StringBuilder result = new StringBuilder();
        try {
            URL realUrl = new URL(url);
            HttpURLConnection conn =(HttpURLConnection) realUrl.openConnection();

            conn.setDoOutput(true);
            conn.setDoInput(true);

            conn.setRequestMethod(mothod);

            for (Map.Entry entry : headerParams.entrySet()) {
            	conn.setRequestProperty(entry.getKey(), entry.getValue());
            }
            conn.connect();

            out = new OutputStreamWriter(conn.getOutputStream(), "UTF-8");

            StringBuffer sbBody = new StringBuffer();
            for (String str : bodyParams) {
				sbBody.append(str);
			}
            out.write(sbBody.toString());

            out.flush();

            in = new BufferedReader(
                    new InputStreamReader(conn.getInputStream(), "UTF-8"));
            String line;
            while ((line = in.readLine()) != null) {
                result.append(line);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }

        finally{
            try{
                if(out!=null){
                    out.close();
                }
                if(in!=null){
                    in.close();
                }
            }
            catch(IOException ex){
                ex.printStackTrace();
            }
        }
        return result.toString();
    }	

	public static String sendGet(String url, Map headerParams,String mothod ) {
        String result = "";
        BufferedReader in = null;
        try {
            String urlNameString = url;
            URL realUrl = new URL(urlNameString);

            HttpURLConnection connection =(HttpURLConnection) realUrl.openConnection();

            connection.setRequestMethod(mothod);

            for (Map.Entry entry : headerParams.entrySet()) {
            	connection.setRequestProperty(entry.getKey(), entry.getValue());
            }

            connection.connect();

            Map> map = connection.getHeaderFields();

            for (String key : map.keySet()) {
                System.out.println(key + "--->" + map.get(key));
            }

            in = new BufferedReader(new InputStreamReader(
                    connection.getInputStream()));
            String line;
            while ((line = in.readLine()) != null) {
                result += line;
            }
        } catch (Exception e) {
            System.out.println("Exception " + e);
            e.printStackTrace();
        }

        finally {
            try {
                if (in != null) {
                    in.close();
                }
            } catch (Exception e2) {
                e2.printStackTrace();
            }
        }
        return result;
    }

}