国际快递查询API接口对接JAVA示例

1、国际物流快递查询API接口 java如何对接国际快递查询接口的需求量很大，例如一些跨境电商B2c网站、快递查询APP、快递柜、跨 境物流公司等都会需要用到国际快递接口。目前市面上的快递接口，以国内快递居多，有些虽然号称支持多家国际快递和国际邮政，但 实际调用时，由于国际快递网站变化较多，所以经常出现不稳定的情况。这里我要介绍的是 快递鸟的国际快递接口，他们一直专做国际快递，支持的国内外600多家快递，大部分国外 主流快递物流公司的接口可以对接，提供的接口也非常可靠。国际快递特性（含国际邮政）.可在两个网站查询到信息：属于万国邮联的国际邮政单号，可以分别在发件国家邮政官网 与目的国家邮政官网查询

2、到数据。相对而言，国内快递一般只需要在一个网站查询数据。.海关问题：国际包裹是跨国包裹，需要通过两国的海关查验，有时候会被海关扣押，进而 导致时效不如国内快递稳定。.运输时间长：国际邮政包裹相对国际快递价格便宜很多，所以运输时间也慢，甚至会需要 1到2个月才能签收。.多语言问题：由于包裹是跨国的，必然会涉及多语言问题，国内客户需要看到的是中文信 息，而国外客户希望看到的是当地语言的物流信息。国际快递API特性（快递鸟）.包含发件国与目的国的数据：快递鸟的API中包含的参数有origin_info （发件国物流信息） 和destinationJnfo（目的国物流信息），所以通过该接口可以让用户看

3、到最为完整的物信息。.智能识别快递状态：当检测到包裹在海关停滞，或者包裹被退回等信息，快递鸟会返回 “exception（可能异常）的状态，帮助用户第一时间发现异常件，从而尽早处理。.按照单号个数计费：由于国际包裹的运输时间很长，完整的运输周期可能需要两个月，而 每天至少需要查询两次以上。所以按照查询单号个数计费而不是按照API调用次数计费，是 最为良心的计费方式。.多语言API：针对不同的快递商，可以按照语言返回不同的结果。包含中文、英文、日语、 印度语、阿拉伯语等等。对接示例这里以快递鸟为例，不同的接口的对接方式比较类似，都需要注册，并生成自己的API key。 接口支持的消息接收方式为H

4、TTP POST参数名称类型说明是否必须Content-Type:application/json定义请求头部的数据格式是快递鸟-Api-Key:string快递鸟后台获取的API是请求body部分的参数的数据格式为请求body部分的参数的数据格式为json格式 请求头部信息参数参数说明类型说明是否必须tracking_numberstring查询快递的快递单号是carrier_codestringKdniao定义的快递商简码，比如 china ems就是是参数说明请求bodychina-emacarrier_code参数是自己定义的快递商家的简码，具体的可以在这里查看。还有需要注意的就是bo

5、dy部分这两个参数需要时json数据格式。大概样子就是这样的 返回参数定义参数名称code参数类型数字参数说明返回码是否一定要返回该项值成功返回200，失败有其他队列的错误码typestring接口类型成功返回Successmessagestring返回信息说明成功返回Succes,失败返回队列的错误信息datajson查询到的物流信息成功返回物流信息，失败返回空其他的状态响应简码可以在这里看到。 返回示例meta: code: 200, type: Success, message: Successdata: items: id: 442f798ea35749e7605d1a73d4181a

6、01, tracking_number: RE113184005HK, carrier_code: hong-kong-post, status: transit, original_country: Hong Kong CN, destination_country: Colombia, itemTimeLength: null, origin_info: weblink: http:/ HYPERLINK http:/www.hongkongpost.hk/ www.hongkongpost.hk/, phone: 852 2921 2222, carrier_code: hong-kon

7、g-post, trackinfo: Details: CO, StatusDescriptionThe item ( RE11318 4005HK ) left Hong Kong for its destination on 10-Oct-2015 , Date: 2015-10-09 00:00destination_info”: weblink: http:八/ HYPERLINK .co/%e2%80%9d .co/”, phone: (57-1) 4722000, carrier_code: colombia-post, trackinfo: Date: 2015-10-22 20

8、:52, StatusDescription: DIGITALIZADO, Details: CTP.CENTRO A,Date: 2015-10-2217:02,StatusDescription:Registro de entrega exitosa,StatusDescription:Details:,Date: 2015-10-2216:55,StatusDescription:ENTREGADO,Details: CD.MONTEVIDEO, Date: 2015-10-22 09:31,StatusDescription: REASIGNADO,Details: CD.NORTE,

9、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: Envio Recibido en la oficina de cam

10、bio internacional,Details: COBOGC1212345678910111213141516171819202122232425262728JAVA接口对接示例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.Buff

11、eredReader;import java.io.IOException;import java.io.InputStreamReader;import java.io.OutputStreamWriter;import .HttpURLConnection;import .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 y

12、ou get from trackingMore;/* Json*/public String orderOnlineByJson(String requestData,String urlStr,String293031323334353637383940414243444546474849505152535455565758596061626364type) throws Exception/headerParamsMap headerparams = new HashMap();headerparams.put(Trackingmore-Api-Key, Apikey);headerpa

13、rams.put(Content-Type, application/json);/bodyParamsList bodyParams = new ArrayList();String result =null;if(type.equals(post)String ReqURL= HYPERLINK /v2/trackings/post /v2/trackings/post;bodyParams.add(requestData);result=sendPost(ReqURL, headerparams , bodyParams,POST);else if(type.equals(get)Str

14、ing ReqURL= HYPERLINK /v2/trackings/get /v2/trackings/get;String RelUrl = ReqURL+urlStr;result=sendPost(RelUrl, headerparams , bodyParams,GET);else if(type.equals(batch)String ReqURL= HYPERLINK /v2/trackings/batch /v2/trackings/batch;bodyParams.add(requestData);result=sendPost(ReqURL, headerparams ,

15、 bodyParams,POST);else if(type.equals(codeNumberGet)String ReqURL= HYPERLINK /v2/trackings /v2/trackings;String RelUrl = ReqURL+urlStr;result=sendGet(RelUrl, headerparams,GET);else if(type.equals(codeNumberPut)String ReqURL= HYPERLINK /v2/trackings /v2/trackings;bodyParams.add(requestData);String Re

16、lUrl = ReqURL+urlStr;result=sendPost(RelUrl, headerparams , bodyParams,PUT);else if(type.equals(codeNumberDelete)String ReqURL= HYPERLINK /v2/trackings /v2/trackings;String RelUrl = ReqURL+urlStr;result=sendGet(RelUrl, headerparams ,DELETE);else if(type.equals(realtime)StringReqURL= HYPERLINK /v2/tr

17、ackings/realtime /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

18、= new StringBuilder();try URL realUrl = new URL(url);HttpURLConnection conn =(HttpURLConnection)realUrl.openConnection();6566676869707172737475767778798081828384858687888990919293949596979899conn.setDoOutput(true);100conn.setDoInput(true);1011021031041051061071081091101111121131141151161171181191201

19、21122123124125126127128129130131132133134135136conn.setRequestMethod(mothod);for (Map.Entry entry : headerParams.entrySet() ，_(); conn.connect();out = new OutputStreamWriter(conn.getOutputStream(), UTF-8);StringBuffer sbBody = new StringBuffer();for (String str : bodyParams) ,_,out.write(sbBody.toString();out.flush();in = new BufferedReader(new InputStreamReader(conn.getInputStream(), UTF-8); String line;while (line = in.readLine() != null) : catch (Exception e) ，：final